
___________________________________________________

NotesUNeed v6.50.20400 - Telic of Dragonblight (EU)
___________________________________________________


Feature-rich, searchable Notes database with many automated features, and additional NuN tooltips for viewing note details.

Make Contact Notes on other Players, or General Notes on anything else.

This AddOn is for making your own custom notes on players, and quests, and items, etc. and does not come with any pre-made notes.
It does provide an Export and Import Feature for sharing of sets of notes, or publishing of note databases.

There is no longer an "Alternative" version of NuN, and the default Modifier keys for creating notes from Container Items and Hyperlinks is now simply "<Alt>-Left Mouse Click". For anyone unhappy with this key-Combo, then they can now specify their own via the NotesUNeed Options frame.

Below is a summary of NotesUNeed functionality, but you should read the Readme.txt file for much more detailed discussion on these subjects.


Main Features of NuN
--------------------

1.) Create Player Notes (aka Contact Notes) :
	- Create Contact notes :
		a) using NuN buttons in the Friends Frame
		b) using NuN buttons in the Looking For Group Frame
		c) using the NuN Micro Buttons described in point 3
		d) use the NuN Modifier when clicking on Player Hyperlinks
			(Default "<Alt>-Left Mouse Click" but can be changed in Options)
		e) using slash commands
		f) via NuN options in the player context menu
		g) Or via any of the automated methods mentioned below
	- auto maintain Friend / Ignore Lists across different Alts
	- auto-note people you Party with
	- auto-note Guild members
	- auto maintain notes on your own Characters plus Levelling notes
	- NuN can auto-populate many details about race, class, guild, etc.
	- Also add your own free Text notes
	- Rate Players via Right click menu and see that Rating in Tooltips
		or tagged to Player Names in Chat

2.) Create General text notes on anything you like :
	- Create General notes :
		a) via the Micro Buttons in point 3 below;
		b) via slash commands;
		c) use the NuN Modifier when clicking on Container Items or Hyperlinks
			(Default "<Alt>-Left Mouse Click" but can be changed in Options)
		d) importing from a Plugin database
		e) receiving notes in-game from other NuN users
		f) Or via any of the automated methods below
	- Options to auto maintain Quest Notes which will save a few kinds of notes
		a) Quest notes that record quest details plus Quest Giver name and location
		b) Quest progress notes which record location when completing quest objectives
		c) Quest History detailing when a given Toon Accepted, and Completed quests 
	- General notes can be saved at Account or Realm level
	- Scripting - LUA scripts can be executed from General notes by :
		a) Using the Run Script button in the frame
		b) Slash command "/nun -x <NOTE_NAME>"
		c) Execute one NuN Note from another NuN Note with the following command :
			NuN_ExecuteNote("<Note Name>")
	- General notes can be assigned the following Types for easy searching :
		a) ITM - Item notes
		b) QST - Quest notes, and quest objective notes
		c) NPC - Notes made on NPCs and Mobs
		d) LOG - NotesUNeed records Transmission logs when you send/receive notes
		e) LUA - Keep your own in-game scripts library and execute notes like Macros
		f)     - or just leave blank ;p

3.) NuN has a MicroButtons panel with 4 buttons for quick access to features. 
This frame can be moved by dragging the small border surrounding the buttons, and can be hidden if not needed (see slash commands). From left to right the buttons are :
	- Options		: 	toggle the NuN Options frame
	- Note Browser	: 	toggle the NuN Note Browser frame
						<Alt> Left Click to browse General notes only
						Right Click to browse Quest History
	- Contact Note	: 	create a note for the current target
						will create a General type NPC note if current target is an NPC
						<Alt> Click to re-open the last opened Contact Note
	- General Note	: 	create a General note
						will create an NPC note if current target is an NPC
						<Alt> Click to re-open the last opened General Note

4.) Note Browser Window.
This is where you can view the list of notes you have :
	- default sorting is your Faction, then Opposing, then General Notes
	- search for notes containing text you specify in the edit box
		a) Left  click : Case insensitive search
		b) Right click : Case sensitive search
	- filter visible notes from the Options Frame
		e.g. to only show Quest Notes, or NPC Notes
	- a tick indicates a General note is saved at Account level
	- hover over a note to see its contents in a Tooltip
	- Right-Click to open the sticky NuN PinUp Tooltip
	- <Shift>Left-Click to paste the note name in to open chat box
	- After filtering and searching to narrow down the visible set of Notes, you can :
		a) Mass delete those listed in the browser frame
		b) Export listed notes for other players to install and Import

5.) Options frame - open via the Microbuttons or slash command "/nun"
Configure NotesUNeed here, or filter the notes to appear in the Note
Browser frame. For example, to just look at NPC notes, or browse 
Quest History for one of your Toons
	
6.) Backup and Restore functionality to save your database
This functionality is kept in separate LoadOnDemand AddOns to save memory.
Both the Backup and Restore processes will execute a ReloadUI()

7.) Import and Export of notes Databases
Share sets of notes with friends, or publish notes databases as a Plugin
for others to Import

8.) Broadcasting & Sending of NotesUNeed Notes
Broadcast Raid Instructions for Boss enchounters or PvP strategy, or
just your enchant selling menu; Or send formatted notes for other
NotesUNeed users to add to their database.


 ** -- SEE THE ENCLOSED README.TXT FILE FOR FURTHER DETAILS -- **
 ** --           ON THE ABOVE FUNCTIONALITY LIST            -- **

	______________
	
	Slash Commands
	______________

/nun   : Toggles the NotesUNeed Options window

/nun -h   : Displays this list of Slash commands

/nun <note title>   : Will attempt the following :
  1. Fetch a saved Contact note with that name
  2. Fetch a saved General note with that title
  3. Create a new Contact note if a player of that name is in your party/raid group or is within target range
  4. Toggles the NotesUNeed Options window

/nun -t	  : Fetches the saved Contact note for the current target, or creates a new one, or shows your own characters note if no valid target. Since v2.00.1800, this command will create notes for NPCs and populate some basic information about them.

/nun -g	  : Creates a new General Note, untitled.

/nun -g <note title>	: Fetches the existing General note with that title, or Creates a new General note with that title.

/nun -ch <name>		: Create a Horde Player Character note for the given name without validating it
/nun -ca <name>		: Create an Alliance Player Character note for the given name without validating it

/nun -tt	: Toggle NotesUNeed Tooltips on/off

/nun -micro	: Toggle the NotesUNeed Microbuttons panel hide/show

/nun -x	<note title>	: Tries to execute the specified note as a Lua Script. If no note exists, then will open the Note Search window

/nun -i <name>	: to stop NotesUNeed trying to ignore a player

/nun -f <name>	: to stop NotesUNeed trying to befriend a player

/nun -resetlists	: to reset NotesUNeed's Friend/Ignore lists to those of the currently logged Alt

/nun -purgeexport	: to clear Exported records and allow the creation of a newly named set of records

/nun -delay [number of seconds] : transmissions to channels have a default delay between each line being sent of 0.33 Use this slash command to change this value. Will report the current value if you do not pass any seconds value.

/nun -restrictwho : stops NuN from automatically trying to gather /who information


Slash Commands for Sending Messages
-----------------------------------

/nun -sendG  "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends General type note text

/nun -sendGF "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends General type note as Formatted text

/nun -sendC  "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends Contact type note text

/nun -sendCF "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]
- sends Contact type note as Formatted text

	where -
	"NOTE_NAME"			= the name of the note or note title
	"SEND_METHOD"		= how to send the note e.g. "GUILD", "RAID", "WHISPER", "CHANNEL", etc.
	"SEND_PARAMETER"	= Optionally required (i.e. who to WHISPER to -OR- the Channel ID/Name)
	
	NOTE: using any of these slash commands will close any currently open note.




	__________________________________
	
	NotesUNeed Functionality Explained
	__________________________________

Contents :

		01  Creating Player Notes
		02  Player Notes & User Definable Buttons
		03  NuN Modifier Key Combo
		04  Colours in NuN Notes
		05  Item Notes
		06  Hyperlinks in NotesUNeed Notes
		07  Sending Notes with NotesUNeed
		08  Automatic Friend/Ignore List Maintenance
		09  Note Deletion
		10  Backup and Restore Functionality
				- And a note on Memory Usage
		11  Export and Import Functionality
		12  Text Searches
		13  Quest Notes and Quest History
		14  NotesUNeed Tooltips
		15  MapNotes
		16  MapNotes-NotesUNeed Tooltip Functionality
		17  NuN & Who Information
		18  Noting the names of another Player's Alts
		19  Party Auto-Noting
		20  Player Rating
		21  Talent Information Recording
		22  Functions Designed for other AddOns to Interact with NotesUNeed
		23  Reserved Character Sequences
		24  Legacy Crash On Exit Solution
		25  Notes & Troubleshooting




01 Creating Player Notes
------------------------

A player note can be created for any name without NotesUNeed validating the player name using dthe following commands :
/nun -ch <name>   for a Horde character note
/nun -ca <name>   for an Alliance character note

(the original    /nun -g <notename>    still exists for creating General Notes - it is recommended that for creating NPC notes you first target the NPC and use the    /nun -t    command or the Contact Microbutton to create NPC notes, as this will populate the note with some basic information about the NPC including your location )




02 Player Notes & User Definable Buttons
----------------------------------------

In the upper left corner of the Player Note Editing frame there are 5 user definable "Header" buttons, and 5 "Detail" buttons.

The default headings for these buttons are : 
	Guild :
		<NuN will try to auto-fill Guild name data in the associated "Detail" button>
	Guild Rank :
		<NuN will try to auto-fill Guild rank data in the associated "Detail" button>
	Real Name :

	e-mail :

	WWW :

When left with their default values, then NotesUNeed will try to auto-fill Guild details in the first two Detail buttons.

However, the player can change these headings to whatever they wish by clicking on them and editing the text for that specific player.
OR by checking the save as default checkbox, then they can change the default Heading for all Contact notes.
So if you don't care about Real Name, e-mail, etc. then you can set up your own default Headings such as Arena Team, Voice Channel, IRC, or whatever you like.

If you use the word "Tooltip" in a Heading, then the associated Details will be included near the top of the NotesUNeed Tooltip; This is not a case-sensitive test, so for example you could change Header button 3 to read "Arena Team tooltip", and the name of the players Arena Team recorded in Detail Button 3 will be included in the NotesUNeed tooltip.

NOTE : An individually changed Heading takes precedence over a user-defined default, which takes precedence over a NuN default.




03 NuN Modifier Key Combo
-------------------------

By default players can <Alt>-Left click on container Items and Hyperlinks to create notes, OR to paste links in to open NuN notes.

If this combination is not working or clashing with modified Blizzard keys, or other AddOns, then there is a "Modifier" button on the Options frame that can be used to specify your own customised Modifier Key Combo.

Simply Mouse Click without any modifier keys to choose which Mouse Button to use. You should see the text on the Button itself update to reflect the mouse button used.

Hold down required keyboard Modifer Keys and mouse Click to Save the specific keyboard Modifiers to use. Again, the text on the button should update to reflect the keyboard buttons that were being held down.

Modified Left mouse Click  : Records left or right keyboard buttons as the same modifier key
Modified Right mouse Click : Records left and right keyboard buttons as different modifiers

By default, the <Alt> key from either side of the keyboard can be used.

EXAMPLE 1

To set up <Left-Control><Left-Alt>-Middle mouse button as the combo to use when creating notes from bag items / Hyperlinks, then do the following :

1.) Click the modifier button with your Middle mouse button while NOT holding down any keyboard buttons

2.) Hold down the <Control> and <Alt> keys on the LEFT hand side of the keyboard, and then RIGHT-mouse click the modifier button

Note that when using the combo to create notes now, then holding down the <Control> or <Alt> keys on the right hand side of the keyboard will not work - you must use the keys on the left side of the keyboard.


EXAMPLE 2

To set up the <Control> key with a Left mouse click as the NuN modifier combo, then do the following : 

1.) Click the modifier button with your Left mouse button while NOT holding down any keyboard buttons.

2.) Hold down <Control> on either side of the keyboard and LEFT-mouse click on the modifier button

Note that you can use either <Control> key when creating notes now.


Combo keys are strictly enforced by NotesUNeed. This means that holding down extra modifier keys means NotesUNeed will ignore the modifier combo.
For example, lets say that you have set up <Control>-Right click as the combination, and another AddOn wants to use <Control><Alt>-Right click. NotesUNeed functionality will only execute when ONLY the <Control> key is depressed, and will ignore <Control><Alt> clicks.




04 Colours in NuN Notes
-----------------------

Can now select your own text colours in notes via colour selection buttons on the note frames.
There are 5 Preset colour buttons, and one Custom colour button for opening the Colour Picker Frame to choose any other colour.
So simply, highlight the text you want to colour in and click on the colour you want.
You MUST highlight the text you want to colour by USING THE MOUSE.
(i.e. text highlighted by holding down the <Shift> key and using the keyboard arrows will not be coloured by NuN)

- Preset colour buttons
1.) Left click to apply the colour to highlighted text
2.) Right click to open up the colour picker and choose your own preset colour choice
3.) <Alt>-Right click to reset the preset colour to its default value

- Custom colour button
1.) Left click to open up the Colour Picker Frame and choose a colour for the highlighted text.
	NOTE that the colour is NOT applied to the text until you click the "Okay" button.
2.) Right click on the Custom colour button to Toggle the display of the colour Tags in the text. This ability should be useful when trying to see why coloured text begins and ends where it does, when you get unexpected results.
	This feature can also be used to generate hex colour codes - see the details on 'tags' below ;)
	NOTE : YOU CAN NOT USE THE BUTTONS TO COLOUR TEXT WHILE SHOWING COLOUR TAGS !!!
The Custom colour button will remember the last colour you chose (even between sessions).

- improved native support for manually entered colour codes
i.e. you can now type in your own colour code tags and they will be applied when you save the note
(e.g. "colour the word |cff0000ffblue|r with the colour it describes")
NOTE that the names of General notes can also be coloured MANUALLY, but highlighting note titles and using the colour buttons will not work.

NuN will make every attempt to apply the colour you have chosen to all the text you have highlighted.
However, you may not always get the results you expect, and this subject is far too complex for me to offer support on how to achieve the colouring you want.

Trying to overlap coloured text is where the main problems will arise - and I'm not going to help you sort out your colouring issues.
Basically, if you don't get the colour results you want, then you should keep the following rules in mind (STUDY THE FOLLOWING CAREFULLY) : 

BLIZZARD TEXT COLOURING RULES

Blizzard text colouring is achieved using tags;
The "opening" tag is of the form "|cAARRGGBB" where :
	"|c" is the main opening tag signalling that the following hex values relate to colour
	"AA" sets the hexadecimal value of alpha setting (i.e. opacity)		[range 00 - FF] (i.e. 0 - 255)
	"RR" sets the hexadecimal value of the Red colour					[range 00 - FF] (i.e. 0 - 255)
	"GG" sets the hexadecimal value of the Green colour					[range 00 - FF] (i.e. 0 - 255)
	"BB" sets the hexadecimal value of the Blue colour					[range 00 - FF] (i.e. 0 - 255)
The "ending" tag for colouring is "|r";
So any text between the "opening" tag, and the "ending" tag will be coloured based on the hex values contained in the "opening" tag.

Simple Example :
"|cffff0000All of the text in this string will be coloured red.|r"

****
NOTE : ONE SINGLE "ENDING" TAG WILL BE USED BY THE BLIZZARD GAME CODE TO END ALL OPEN COLOUR TAGS.
****
So for example, take the following text which is initially not coloured at all :

 <----- all white text ------->
"BLUE_TEXT GREEN_TEXT BLUE_TEXT"

1.)
To manually colour the BLUE_TEXT blue, and the GREEN_TEXT green, you "MIGHT" try the following, but you would be wrong :

"|cff0000ffBLUE_TEXT |cff00ff00GREEN_TEXT |rBLUE_TEXT|r"			<- copy this in to a NuN Note frame and save to see the effect

However, this would NOT achieve the desired result, and the final " BLUE_TEXT" would NOT be coloured in blue, because the first "|r" would be treated by the Blizzard code as the "end" for BOTH the blue AND green colouring tags.
i.e.
 <- blue -><- green -><-white->
"BLUE_TEXT GREEN_TEXT BLUE_TEXT"

2.)
In order to get the desired effect you would need the following tags :

"|cff0000ffBLUE_TEXT |r|cff00ff00GREEN_TEXT |r|cff0000ffBLUE_TEXT|r"		<- copy this in to a NuN Note frame and save to see the effect
i.e.
 <- blue -><- green -><-blue ->
"BLUE_TEXT GREEN_TEXT BLUE_TEXT"

The most straightforward way to achive this with NuN is to take 3 steps and colour each phrase individually.

In order to achive this using only 2 colouring steps, then the NuN colour preset buttons you MUST apply the colours in the correct order, applying colours to the INNER words first.
If you highlighted the whole phrase above and applied the blue colour first, followed by colouring the "GREEN_TEXT" second, then you would result in case 1.) above and the final words would be white.
However, if you colour the "GREEN_TEXT" first, and then select the whole of the text and apply blue, you will get the results you want, because NotesUNeed works out what you want to do.

NotesUNeed can NOT remove colouring from highlighted text, and then apply the colour you want because NuN isn't aware of what colour tags may already be in effect BEFORE the first character in the highlighted selection. It would be possible for NuN to work this out, but things are getting too complicated so just work out how you want colours to be applied and do it yourself ;p

Basically, your text could get VERY complicated with colour tags VERY quickly, so don't blame me if you ruin your own note formats ;)

Having said all that, the integrity of the Notes database should be in no danger. Just your own ability to manage your own colour tags ;)

REMEMBER : you can always Right-Click on the Custom colour button to display the colour tags within the note text, and then manually edit/delete them, and then Right-Click on the Custom colour button again to apply the new colours, or use the Save button to apply the colours and save at the same time.




05 Item Notes
-------------

<NuN Modifier>-Click on a Container Item, or Hyperlink to create a note on it;

OR IF YOU HAVE A NuN NOTE OPEN then <NuN Modifier>-Clicking will paste the Hyperlink in to the open NotesUNeed note.

As well as creating notes from items in your own character sheet by <NuN Modifier>-Clicking on them, it is possible to create notes on items equipped by other people when the inspect frame is visible. For various reasons, the way to do this is not very intuitive, and you must <NuN Modifier>-Click the corresponding slot in your character sheet while the Inspect Frame is open.  i.e. to note the fantastic Staff that mage has equipped, you must have your character sheet up, as well as the Inspect frame for the mage. Now when you <NuN Modifier>-Click on your equipped weapon slot, a note will be created for the inspected targets weapons slot. When the Inpsect frame is not visible, then you will create a note for your own equipped weapon.

You can also create/access NuN notes from the AH by <NuN Modifier>-Clicking on the Icon Picture for that AH Item.

When you create notes on items by <NuN Modifier>-Clicking on items in bags, character sheets, or Hyperlinks in the chat frame, then the note title is the Hyperlink for that Item. i.e. the coloured item name surrounded by square brackets.  However, to access the note from the command line you do not have to enter "/nun <Hyperlink>".
For example, if you have a note for the purple epic [High Warlord's Battle Axe], then you can access it from the command line by simply typing "/nun High Warlord's Battle Axe". (Still case sensitive.)

Since v6.43.20400, NuN will ignore Item Unique IDs, Enchants, & Jewels, and will treat all objects with the same item ID as the same items.
No data fix is included in the v6.43 upgrade to make existing notes generic, as it could lead to duplicates and NuN wouldn't know which was the best to delete - so its possible people may have to delete and/or re-create some item notes...




06 Hyperlinks in NotesUNeed Notes
---------------------------------

Coloured text must be stripped of its colour before transmission via the Chat Channels, but coloured Hyperlinks CAN still be sent - NotesUNeed automatically "bleaches" text before transmission, but will leave Hyperlinks intact.

Unfortunately it is not possible to click on Hyperlinks in NotesUNeed notes - this is a restriction of the Blizzard UI.

However, you can still access them via the NuN hyperlink button, in the top right hand corner of the Note Editing frame.
i.e. the button with the pair of square brackets "[]".

This functionality basically uses the Send Notes via Chat Channels functionality to pull Hyperlinks out of the text and send them to the SELF so that they appear in the Default Chat Frame, where you will now be able to click on the Hyperlink as normal, or <NuN Modifier>-Click it to create a NotesUNeed note for that individual item containing all its details.

If you highlight individual Hyperlinks in the text before using the button, then only those selected Hyperlinks will be "echoed" to the chat frame.
If you highlight text that doesn't contain any Hyperlinks, then nothing will be echoed to the chat frame.

If the Chat Edit Box is open, then the Hyperlink button will paste Hyperlinks in to it, rather than echoing them to the chat frame.




07 Sending Notes with NotesUNeed
--------------------------------

There are 2 methods of note sending in NotesUNeed :
	1.) Un-Formatted
	2.) Formatted

Un-Formatted note sending simply broadcasts the text of the chosen note via the chosen method for other people to read - so you can broadcast your enchant selling list, or Raid instructions for a boss encounter, or PvP Raid strategy, etc.

You can fine-tune the look and style of note broadcasts by test sending them to your SELF.

Formatted note sending is provided so that other NotesUNeed users will receive the note and add it to their own database. Users of NotesUNeed will not see the individual lines of Formatted notes in the chat, they should simply see status messages, and the note should open automatically for the recipient.
HOWEVER : the individual lines of Formatted notes may still be visible to players who do NOT have NotesUNeed installed if you are trying to send the note over public channels, so be careful where you spam. I would recommend that in-game note sharing via formatted notes should be achieved via individual Whisper, or sending in carefully controlled environments such as Guild or Custom channels.

If you send a note to someone who already has a note with the same name, then the recipient will be shown a Warning Dialog box allowing them to choose whether they want to Replace their existing note, or cancel receipt of the note and keep their original version instead.
There is also a third option allowing the sent note to be merged with the existing note by "ALT-Clicking" on the Replace button.
When notes are merged, then the newly sent text will be appended to the end of the existing note's text. Currently, other values such as those populated in DropDown boxes will still be set according to the received note, and will replace old values used in the original note.

When sending notes over Channels, then NotesUNeed introduces a 0.33 second delay between each line sent. This can be changed by using the

/nun -delay <#_OF_SECONDS>			-- e.g. /nun -delay 0.5

If you change the value to less than approximately 0.3, then you are likely to receive Blizzard errors saying that you are sending too much traffic.

The value of the delay is also displayed in an edit box on the Transmission frame, just above the Transmit button, where it can be changed easily before sending a note.
NOTE that you have to press <Enter> or click on Transmit for the value in this edit box to be saved.

For the Player notes, the information displayed in the drop down boxes and user definable buttons comes from the SAVED details of the note. If you show a note, change their Profession without Saving, then send the note, the profession actually sent will not be the one you just specified, but the one still saved.
However, during development I found that it was much more useful to be able to change the free text of both the Contact and General style notes, and send it without having to save the note first. I believe this could be more useful in the live version also, as you may wish to edit or censor certain details of a notes free text before you send it, without actually saving your changes.

See also the Hyperlinks in NotesUNeed Notes section of the Readme file.




08 Automatic Friend/Ignore List Maintenance
-------------------------------------------

For example, when you ignore one person on one Alt, then NotesUNeed can automatically try to ignore that person when you sign in to another Alt. By default NotesUNeed will send a message to the Chat frame informing you of when it is adding/removing Friends/Ignores. A "Silent Mode" option is available, if you wish to suppress the extra messages created when NotesUNeed adjusts your lists.

You may find that NotesUNeed continues to try and adjust a Friend/Ignore when you log in - this is usually caused by trying to ignore someone who is not online, which therefore fails, and NotesUNeed will try again next time you log in. There are several aspects of this issue to consider :
A - You can use "Silent Mode" so you don't have to see the messages
B - If you prefer not to use "Silent Mode", so you can keep an eye on what's happening, but you are tired of trying to ignore someone who never seems to be on line, then check the extra Messages NotesUNeed is displaying to see the name of the Player NotesUNeed is trying to ignore, and do one of the following :
	1.) sign in to your Alt that IS ignoring the named player, and stop ignoring them
	2.) use the new "/nun -i <Player Name>"  command to force NotesUNeed to stop trying to ignore the named player
C - sometimes your NotesUNeed friend and ignore lists can be corrupted by Deleting one of your Alts which had Friends/Ignores that your other Alts were not aware of  OR  when a character on one of your lists is Deleted from the Server, and NotesUNeed keeps trying to refer to them.
In these cases, you will have to use the new "/nun -i <Player Name>" function.
When you use the "/nun -i <Player Name>" option, then if you log in to an Alt that IS ignoring that Player, NotesUNeed will remove them from that Alt's Ignore list automatically.
Note that just in case your Friends data should become corrupted, there is also a corresponding "/nun -f <Player Name>" function which will force a player to be removed from the NotesUNeed friends list.
If you wish to reset your Friends/Ignore lists to the current Friends/Ignores of the Alt you are currently logged in to, then there is a third slash command option "/nun -resetlists"




09 Note Deletion
----------------

Sometimes you may find that you can not delete a Player note : Usually this is caused when you are using NotesUNeed to automatically maintain your Friends/Ignore lists. Basically, NotesUNeed needs to keep these notes, and will try to protect them from deletion.

Sometimes you may delete a note, only to find that it appears in your note list again. Remember that if you have selected to automatically maintain notes for Friends/Ignores, or Guild/Party members, then a note may be recreated by NotesUNeed in the background.




10 Backup and Restore Functionality; And a note on Memory Usage
---------------------------------------------------------------

NotesUNeed itself takes up approx. 0.8Mb of memory, which is small/average compared with other AddOns.
Obviously, the more notes you have, the more memory this AddOn will use - as a rough guide I have found that on average each note takes up only approximately 1kb of memory, meaning that 1000 notes will use roughly 1Mb, and so on. (If you use all 6000 available characters in all of your notes, then your average amount of memory per note will be much larger)

In order to keep a second copy of your Database as a Backup, then obviously this will use twice the memory, and for this reason, the Backup databases is kept under a second AddOn called "NotesUNeed_Backup", and this AddOn is flagged as Load On Demand, and will only use memory if you actually use the Backup or Restore buttons on the NotesUNeed options frame.
If you are worried about memory and have a large NotesUNeed database, then I would consider relogging after using the Backup or Restore buttons.




11 Export and Import Functionality
----------------------------------

I have chosen to keep this functionality relatively simple. Basically, if one person creates a file of notes via the new Export function, then another player will be able to Import them in to their own database.
NOTE: Imported records are all saved at Account Level, and will overwrite any notes that already exist with that name.
NOTE: You can not Export Contact style notes, or Quest History.  ONLY General style notes can be exported.
Exporting the same record more than once will not result in duplicates within the export file; You can therefore filter multiple sets of records to be exported, and not worry about exporting the same record more than once.

New Export button available on the Notes Search/Browser frame. So search for the notes you want to Export, so that they appear in this frame, and then click on Export. You will be prompted for a name with which the set of exported notes can be associated. Confirm export of the records, and you will be informed of how many records were exported in the Chat window.
The exported records will be recorded in the file NotesUNeed_Export.lua, in the same SavedVarialbes folder as your normal NotesUNeed.lua database file.
Once you have created a set of records, then the Export button can ONLY be used to add more notes to that record set.
If you want to delete the records you have exported and create a completely new record set with a different name, then you must use the Slash command "/nun -purgeexport". This clears the NotesUNeed_Export.lua file in the saved variables directory, and you can then use the Export button to create differently named sets of exported notes. (Obviously if you want to save a set of exported records, then you must take a physical copy of the NotesUNeed_Export.lua file, before using the "/purgeexport" command.)

In order for another user to Import the notes you created, they need to copy your NotesUNeed_Export.lua file in to the NotesUNeed AddOn folder on their computer. (i.e. NOT their SavedVariables folder).  In order to do this, they will have to replace the existing NotesUNeed_Export.lua file that already exists in their AddOn's folder.  i.e. \WoW\Interface\AddOns\NotesUNeed\NotesUNeed_Export.lua

New Import button available on the Options frame. This will only be available for use if the user has a NotesUNeed_Export.lua file in their AddOn directory which contains notes available for Import. NotesUNeed_Export.lua is blank when you first install NotesUNeed.
When the user clicks on the Import button, they will be prompted with a general name identifying the set of notes available for Import, together with the number of records that will be imported, and will be offered the choice of continuing to Import, or cancelling the action. If they click on Import, then they will receive a message in the chat window informing them of the number of records that were imported.

The Export function is kept under a second AddOn/folder name of "NotesUNeed_Export", and is Load On Demand.

IMPORTANT : Basically, one person can create one NotesUNeed_Export.lua file, and this can then be placed in another user's AddOn folder (NOT the Saved Variables folder), and they will then be allowed to Import those notes. If another person gives you some more notes to import, then you will replace the NotesUNeed_Export.lua file and will import only those notes. In other words you can only import one set of notes at a time. If you have 3 NotesUNeed_Export.lua files from 3 different downloads and want to add them to your own NotesUNeed database, you will have to do the following :
1.) Replace your current "\WoW\Interface\AddOns\NotesUNeed\NotesUNeed_Export.lua" file with the first file you wish to import
2.) Log in to WoW, and use the NotesUNeed Import function
3.) Log out of WoW
4.) Repeat from step 1.) but with the next set of records you wish to Import

If you want to ensure that you don't re-import the same set of notes, or if the NotesUNeed_Export.lua file in your AddOns folder is very large and you want to save memory, then after you have imported the notes, the safest thing to do is to Re-Install the NotesUNeed AddOn - this will replace the NotesUNeed_Export.lua file with a blank version, thus disabling the Import option on the Options frame.

NOTE : you should not normally need to worry about the size of the NotesUNeed_Export.lua file in your SavedVariables folder as this part of the AddOn is Load On Demand, and will only use memory after you have used the 'Export' button in the Note Search frame. If you have exported a very large number of notes, then it may be worth re-logging to save memory.




12 Text Searches
----------------
Text searches are case-insensitive since version 4.50.

If you need to carry out a case-sensitive text search, then you can only do so by specifying some text to search for in the note Search Frame, and RIGHT-Clicking on the Search Note button.

The Text search box is now visible in the Search Frame when filtering by most types of Notes, not just when specifically searching for Text. This means that after filtering for Quest Notes for example, you can then search for the phrase "Scorpid Sting" and NotesUNeed will search for that Text only in the Quest Notes you previously specified.

I have chosen not to blank the text search box on entry/exit, as it allows you to repeat the search without having to retype the text, and will not restrict your search results when filtering notes until after you click on the Search Button. The one exception to this rule is when you have specifically requested a text search from the Options Drop down, and not blanking the text box allows for the possibility of a 2 tiered text search as follows:
i.e. It is possible to search for 2 text words or phrases in the NotesUNeed notes, for example you might wish to view only notes containing the phrase "Big Sword", and then search among those notes for the word "Light". (Sorry that this isn't an obvious solution ;) First you must open up the Search Frame by clicking on the Browse All Microbutton, and entering some text in the Search Text Box (You don't have to Click on Search, or press <Enter>, just put the first text word/phrase you are searching for in the box). Next, open up the NotesUNeed Options Frame (the Search Frame will close automatically) and select Text from the Search For Drop Down selection box, and click on Search. NotesUNeed will filter All your notes based on the text you entered in the first Search Text box and list them for you.  Now you can enter a completely new word/phrase in the Search Text box, and NotesUNeed will only search amongst those Notes already returned after the first search.




13 Quest Notes and Quest History
--------------------------------

NotesUNeed Quest Notes and Quest History

It is important to be clear that NotesUNeed keeps notes on Quests separate from a Player's Quest History.
A Quest Note is a normal NotesUNeed note detailing the Quest's name, description, objectives and rewards.
Notes recording when and where you were when completing Quest Objectives are also normal NotesUNeed notes of type QST

However, the Quest History recorded by NotesUNeed is not a normal series NotesUNeed notes, but simply a list of Quests with the associated location and time when they were accepted, completed, and handed in.

- new buttons allow notes to be made on the Quests in the Quest Log, similar in functionality to how the Friends Frame buttons work.

- a new option is available to allow NotesUNeed to automatically record a Quest Note whenever your Quest Log is updated, and also keep track of your characters' Quest History

- new search Options are available in the Options Frame to filter notes by type, including Quest Notes, OR Quest History

- Quest Notes are notes like any other but with a type of "QST" allowing them to be filtered and examined separately

- It is also possible to Filter/Search by Quest History, but these are not NotesUNeed notes. When filtering by Quest History, you are simply viewing a list of the Quests you have had in your Quest Log. The Tooltip will no longer display the Quest Note tooltip, but will display the details of when and where you were when you Accepted, Completed, and Handed In the Quest. A tick beside the Quest name will indicate that that Quest has been Completed and Handed In and is no longer in your Quest Log. If you have the details of the Quest stored in a Quest Note, then a little note symbol will appear beside the entry, and clicking on the Quest will show the Quest Note. However, if you do not have a Quest Note for that particular quest (because you have deleted it), then no symbol appears beside the Quest name, and clicking on it will show a blank Quest Note.

- It is important to note that if you are Searching Quest History, and you raise the corresponding Quest Note, then clicking on Delete in the Note editing frame will no longer Delete the Quest Note, but will instead Delete the entry in your Quest History. To delete the Quest Note you would have to close the Quest History Search Frame, Search seperately for that Quest Note, and then delete the Note itself.

- Quest History entries are ONLY displayed when you choose to Filter specifcially for Quest History from the Options Frame. If you search for All, or Notes, or Quest Notes, you will NOT see any Quest History Entries - only actual Notes.

- The Quest Accepted Location and Datestamp will not necessarily  be accurate. For example, when you first install the mod, or when you first check the option to automatically record Quest Notes and History, then NotesUNeed will update your quest history on the next Quest Log Update, and all your current quests will be noted as accepted at that time and in that place. Similarly, abandoning a quest and accepting it again later will not update the accepted location or date unless you take the trouble to delete the Quest History entry for that quest after abandoning it.

- Due to some inconsistancies in the WoW treatment of Quest completion, it is not always possible for NotesUNeed to detect when a Quest is complete, or even handed in.

- The Quest History search will display the level of your character when that history entry was created. The level detailed within the Quest Note is the appropriate recommended difficulty level associated with that quest, not an individual player level.

- Quest History is sorted to show the most recently accepted Quests first

- Where a Quest has multiple stages under the same Quest name, and you have Auto-noting of Quests turned on, then NotesUNeed will try to append the details of the next stage of the Quest to the existing Quest note. Again, the WoW API does not always send notifcaion of stage completion, and details can not always be updated. Note that where you play through quest stages out of sequence by playing the same quest with different Alts at the same time, then the text in the note may also be listed out of sequence.

- Turning auto-noting of Quest Logs and History, off and on, while continuing to make progress in those quests may result in strange looking data, especially where quests being logged have multiple stages.




14 NotesUNeed Tooltips
----------------------

The contents of the NotesUNeed tooltips can be controlled in 4 different ways :

1.) Control the amount of text per line, and in total from the Options frame

2.) Change a user-definable Heading in the Player Character Note to contain the word 'Tooltip' (not case-sensitive), and the corresponding Detail will be displayed in that Notes Tooltip.
(See "02 Player Notes & User Definable Buttons")

3.) By default, all note text is available to be displayed in the tooltip; But this can be restricted by using the tags  "TT::"  and  "::"  to start and end the text you wish displayed.
e.g. from the following :-

	"Text I don't need to see in a tooltip TT::Useful Information:: followed by more unimportant text"

then only :-

	"Useful Information"

will show in the tooltip.


4.) Use the "Minimise MouseOver Target Tooltips". It can be annoying to see large NotesUNeed notes popping up on screen when mousing over players in the 3D environment, and this is where this Option can be useful. It restricts the information displayed in the NotesUNeed tooltip to a bare minimum when mousing over them in the Game world, while still allowing full tooltips when mousing over their Portraits, etc.
If you WANT to see the FULL version of the tooltip while this still leaving this Option turned ON, then hold down the <Alt> key before mousing over them.

5.) To make the names of another person's Alts appear in their tooltip, they should be included in that person's note in the following format :
<ALT:AltName>
For example if a player called "Wibble" had an Alt called "Wobble", then in the NotesUNeed note for "Wibble", you could include the following text "<ALT:Wobble>"
(And vice versa, including the text "<ALT:Wibble>" in Wobble's note)
See also section "17 Noting the names of another Player's Alts"





15 MapNotes
-----------

I have integrated with the MapNotes (Fan's Update)
Versions of MapNotes that NotesUNeed has been tested with so far :
	MapNotes (Fan's Update) v2.00.11200 and later...

I check for the presence of the MapNotes_OnLoad function as evidence that MapNotes is installed.

The basic changes are that you can now create MapNotes from NotesUNeed, and when you hover over a MapNote icon whose Main line is equivalent to a NotesUNeed note title, then you will also see the NotesUNeed tooltip for that MapNote. This means that it will be possible to see the NotesUNeed tooltip for MapNotes that have already been created, as long as their name is the same as a NotesUNeed note.

I have used similar logic to that used by the MapNotesTarget AddOn, which can be used to create MapNotes for targetted NPCs. So, friendly NPCs create Green MapNotes, neutrals create Yellow, and enemy NPCs create Red MapNotes.  I have gone further, however, and you can create a MapNote from any Generic NotesUNeed note - default colour is green.

Also, if you are Auto-Noting quests, and have the flag to Auto-MapNote NPCs, then NotesUNeed will create a purple cross MapNote when ever you accept a new quest. ( I chose to implement similar logic to MapNotesTarget myself, rather than make NotesUNeed dependant upon it, mainly because, MapNotesTarget also adds profession/level to the MapNote name, which then breaks the link to the NotesUNeed notes, and stops the NotesUNeed tooltip displaying. Plus, I have also extended the functionality, so..... )

From a MapNotes point of view, the note Merging is basically the same as that found in the MapNotesTarget AddOn. MapNotes will reply with a warning if you are too close to an existing MapNote to create a new one for the NPC.  In that case, MapNotesTarget allows you to merge the NPC MapNote with the existing one, so if you had a note called  "NOTE1", and you were trying to create a new note for an NPC called "NOTE2", but were very close to "NOTE1", then you could choose to merge them and the MapNote would then be called  "NOTE1 | NOTE2".     Basically, I have done a similar thing with regard to the MapNote information with a couple of differences :

1.) I just merge notes automatically when you are too close to an existing one; Up to a maximum of 5 NotesUNeed notes can be merged/added to an existing MapNote. After 5 NotesUNeed merges, then you will just have to move a little bit away from the current MapNote to create a new one.

2.) I have added another tooltip window which will list the NotesUNeed notes that have been merged in one MapNote. To see the NotesUNeed tooltip for the individual notes, you need to move your cursor over this list of buttons.


MapNotes : PLEASE NOTE : MapNotes are basically stored at Account Level, while it is possible to create NotesUNeed notes at Realm, or Account level.  It is also possible to create MapNotes from NotesUNeed notes saved at either level; However, if you have a NotesUNeed note saved at Realm level, create a MapNote from it, then change Realms, you will not be able to see the associated NotesUNeed note tooltip.  In order to see NotesUNeed tooltips on any realm, you must save the NotesUNeed note at Account level.  So if you believe that a NotesUNeed tooltip is not being displayed when it should be, please check at what level it is saved, and which Realm you are currently on :)




16 MapNotes-NotesUNeed Tooltip Functionality
---------------------------------------------

There is a delay leaving the NotesUNeed buttons available to click when your mouse leaves a MapNote - But the tooltip and NotesUNeed Popup frame will refresh immediately when you mouse over any other MapNote.
If you are having trouble clicking on a NotesUNeed Popup button for one MapNote, because you can't avoid mousing over other MapNotes to get to it - then hold down the <Control> Key,  and Mousing over other MapNotes will be suppressed.




17 NuN & Who Information
------------------------

NuN will try to automatically update Contact notes with player information where possible. You should not see the Blizzard Who Frame opening, but may see standard Who message responses in the Chat frame in certain circumstances.

If the Chat Messages are too frequent, then it is possible to use the following slash command :

"/nun -alternativewho"

When set, NotesUNeed will try to implement the Who commands via a different method.

For anyone with big problems with the way NuN requests Who information, then the last resort is to use the following slash command to turn off automatic Who Requests :

"/nun -restrictwho"

Even with restricted Who functionality, it should still be possible to manually use the Who Button on the Player Note edit frame.




18 Noting the names of another Player's Alts
---------------------------------------------

To make the names of another person's Alts appear in their tooltip, they should be included in that person's note in the following format :
<ALT:AltName>

So for example, if a Player called Alice has two alts called Bob and Fred, then to see the names of Bob and Fred in Alice's tooltip you should -
a.) open up Alice's NuN note
b.) insert the text "<ALT:Bob>" anywhere in the note text
c.) insert the text "<ALT:Fred>" anywhere in the note text

Likewise, if you then want to see the alt names of Bob and Alice in Fred's note, you have to go through a similar procedure

There is a shortcut for inserting ALT text from the Guild frame, where you can open Alice's note for example, and then <ALT>-click on the NuN Note symbols for Bob and Fred to auto-insert them in to Alice's note. So all the Alt setup for Guild members can be done via mouse clicks.




19  Party Auto-Noting
---------------------

With auto-noting turned on, NotesUNeed will create notes for all players you Party with.
This does not include Raid members not in your local group, and does not note changes in Battlegrounds where many players are from different Realms.
Obviously if you form a Party BEFORE entering a BG, then auto-noting will take place.
The specific number of times you have partied with someone on your currently logged Alt is displayed in the Player note frame for that Player, and also in the Note Browser frame.
If you want to see when you last partied with that person, or when & how often you have partied with them while playing a different Alt, then this information is displayed in the Tooltip when you hover over the "Parties : " label on the Contact note.

When hovering over the "Parties : " label on the Contact note, NotesUNeed will display a tooltip with the following information :
a.) Which of your Alts has partied with that player
b.) How many times that Alt has partied with that player
c.) The date on which that Alt last partied with that player




20  Player Rating
-----------------

You can "Rate" Players via the appropriate Drop Down box on the Contact Note frame.
You can also rate Players via the Right-Click Player Menu e.g. Right-clicking on Target Portraits, etc.

Can now customise the Player Ratings.
Open up any Player note;
Click on the Player Rating DropDown button;
<Control>-Click on any Player Rating button to change it via 2 dialog boxes : 
 Box 1 allows you to change the Player Rating text
 Box 2 allows you to change the Tooltip text
<Alt>-Click on a Player Rating button to reset it (and the tooltip) to the NuN default value


--OPTIONAL SUPPORT FOR THOSE WITH THE "Black List" ADDON--

When customising Player Ratings using the technique described above, then checkboxes will allow you to specify whether that Player Rating should also Black List the player;
A further two check boxes allow you to specify whether the black listed player should also be Ignored, or trigger a Warning.
Now when you select that Player Rating for a Player, then they will be automatically be added to the Black List AddOn database.
The Black List reason will be auto populated with the NuN Player Rating and Tooltip text.
If you select a different NuN Player Rating with different Black List criteria, then the Black List details will be updated in the background.
If you select a different NuN Player Rating with no Black List criteria, then the Black List details will be left untouched.
If you remove someone from your Black List, then their NuN Player Rating will be reset to blank if it can detect that the Player was Black Listed from NuN;
i.e. players Black Listed from NuN will have a reason for black listing pre-fixed with "[NuN]"

Black List AddOn : http://wowui.incgamers.com/?p=mod&m=4926




21 Talent Information Recording
-------------------------------

NuN will try to record Talent tree details when collecting Player information.
Players must be within range when you create the Note or use the Target Info button.
This information will be displayed in Tooltips in the following ways :
a.) in the general NuN Tooltip for a Player, the Spec and summary of points spent will be displayed.
The main Talent description will be based on the branch in which the most points have been spent
e.g. for a Shaman the description might read :
Elemental 40-7-23
b.) hovering over the Class button in the Contact note editing frame will give much more detailed information about that Player's Talents

NOTE : NuN does not try to gather talent information automatically when creating notes en masse, i.e. for Friends, Guild mates, etc.
There is no way to manually edit this information.




22 Functions Designed for other AddOns to Interact with NotesUNeed
------------------------------------------------------------------

Much of the functioanlity of NotesUNeed for note creation can be accessed through calling the slash command handler directly with the appropriate variables.

The following 2 functions have been provided specifically for other AddOns to access NotesUNeed note text for display and update.


1.)
function NuNAddOn_ReturnText(noteType, noteName)

Arguments to pass :
  - noteType = "General" / "Contact"
  - noteName = name of the note EXACTLY

If an error occurs, and the returned text is nil, then the second Return Parameter can be examined to determine the problem
  1 =	"Invalid noteType"
  2 =	"General Note not Found"
  3 =	"Contact Note nof Found"


2.)
function NuNAddOn_InsertText(noteType, noteName, noteText, pos)

Arguments to pass :
  - noteType = "General" / "Contact"
  - noteName = name of the note EXACTLY
  - noteText = the text to be inserted
  - pos = specifies how and where the text is to be inserted
	-1		:	Replace the entire text
	#		:	a number specififying the character position after which to insert the text
				0 = beginning, 1 = after first character, etc.
				(will append the note if target text is not long enough, but will ALSO return error code 5)
	<nil>	:	omit to append the text at the end of the note (i.e. default behaviour)

NOTE : its the responsibility of the caller to ensure that there are appropriate carriage returns, spearators, etc.
i.e. the function simply inserts/appends where it is told, so if you want a couple of blank lines between the old and new, then they must be included in the passed text

Function does not return anything when succesful
If an error occurs, then the Return Parameter can be examined to determine the problem
 1 =	"No text passed"
 2 =	"Invalid noteType"
 3 =	"General Note not Found"
 4 =	"Contact Note not Found"
 5 =	"Text appended to note because specified insert position not found" (*non-critical error)




23 Reserved Character Sequence
------------------------------

The following character pairs have special meaning in NotesUNeed, and if you use them in your notes, then they will be substituted as follows :
n	->	\n	(i.e. a new line character)
q	->	"	(i.e. a double quote)
s	->	\	(i.e. a slash character)

The reason for this substitution is explained below in the "Legacy Crash On Exit Solution"

Due to the wish to support user-coloured text within notes, the following character sequences
||c
||r
will always be contracted to : 
|c
|r




24 Legacy Crash On Exit Solution
--------------------------------

This was an old error that occurred when WoW Patch 1.10 was released, but which still has consequences today, and gives rise to the need for NuN to Reserve the Character pairs mentioned above.

First of all, my proof that this was a WoW bug, and not a specific NotesUNeed bug, is that copying a 'problem' note in to another Note-Taking AddOn such as NoteIt, and saving it there, would also cause WoW to crash on exit. And once I recognised the cause of the crash, then it was possible to enter completely new notes in other note taking AddOns and trigger the problem even when NotesUNeed was not installed.

As I can't see Blizzard's code for WoW, its difficult for me to be exact about the cause, but after a lot of testing and hair pulling my conclusion is that WoW splits text strings being saved to the Saved Variables folder in to chunks for processing, and since WoW patch 1.10, it adds its own escape characters, and special-character substitutions.  Based on my debugging of notes that would cause the problem, and minimal changes like inserting a single space which would then solve the problem,  I can only believe that the WoW executable is inserting an escape character prior to the final double quotation mark of a string, effectively leaving the string un-ended,  OR possibly adding an escape character to a full buffer leading it to overflow/loss of a final character.

Anyway, my solution has been to substitute characters that would normally be 'escaped'/substituted by WoW, before it sees them.
Currently I am only substituting new-line characters, double-quotation marks, and the '\' character; Using the following 3 character pairs :
n
q
s
As a consequence of this, users should not use these character pairs in their notes as NotesUNeed will replace them when displaying Notes.
This is all done behind the scenes and users should write notes as they normally would.

There is a very small chance that another type of special character being 'escaped' by the WoW executable may cause another crash. If so, just send me your NotesUNeed database, and I will ensure that I cater for that special character also.




25 Notes & Troubleshooting
--------------------------

1. Many of the NotesUNeed frames and the Pinned tooltip are now moveable and scaleable in Version 2. This means that they can disappear off screen when you increase their Scale, or the UI Scale from the WoW Video Options panel (or from the Titan panel).  If you are clicking on a button but the frame, or tooltip does not appear to be responding, try to reduce the NotesUNeed Frame/Tooltip scales, and/or the UI Scale temporarily (preferably as low as you can go), and see if the frame/tooltip now responds/appears.Once you have located the frame, move it towards the top left of the screen, and restore your UI scale to where you need it. If all else fails try resetting the NotesUNeed Options to their defaults, and then exiting WoW, entering the world without the NotesUNeed Addon loaded (preferably temporarily remove the NotesUNeed folder from the Addons folder completely while you log on),  then restore the NotesUNeed mod folder, and log on again. Hopefully, this should restore your NotesUNeed frames to their original position. The last resort after this is to edit/delete the "layout-cache.txt" file in the WoW\WTF\Account\<Account Name>\<Character Name> folder, and restart the game.

2. When importing players in to your Ignore list from the NotesUNeed database, note that a character needs to be on line to be succesfully ignored. This is a restriction of the WoW API.  Every time you log on, NotesUNeed will make another attempt to ignore any Contacts which it failed to ignore previously, but it will only attempt this once, as periodic background attempts to ignore these players would only generate puzzling "Player not found" messages in the chat window. If you don't want NotesUNeed to continue to attempt to ignore someone when you log in, then use the slash command "/nun -i <player name>" (if you are not sure of the player name, then turn on NuN verbose friend / ignore maintenance and relog in again, and NuN should display the name of the player it is trying to ignore)







	______________
	
	Change History
	______________

Changes in v6.50.20400 from v6.48.20400
---------------------------------------

- Talent recording now works as intended ;p
Need to be within range when creating a new note, or using the "Target Info" button
Main NuN Tooltip for player will show talent summary
Talent details will be shown in a special tooltip when hovering over the Class box in the Note itself





Changes in v6.48.20400 from v6.47.20400
---------------------------------------

- fix to Friend frame note fetching for Offline friends

- fix to Talent tooltip issues when hovering over Class drop down boxes



Changes in v6.47.20400 from v6.46.20400
---------------------------------------

- compatibility update for 2.4.3



Changes in v6.46.20400 from v6.45.20400
---------------------------------------

- fix to fix to try and minimise the display of Contact tooltip details when hovering over General items with the same root name



Changes in v6.45.20400 from v6.43.20400
---------------------------------------

- NuN will now try to record Talent tree details when collecting information.
Players must be within range when you create the Note or use the Target Info button.
This information will be detailed in the Tooltip when :
a.) in the general Tooltip information for that Contact
The main Talent description will be based on the branch in which the most points have been spent
e.g. for a Shaman the description might read :
Elemental 40-7-23
b.) hovering over the Class button in the Contact note editing frame will give much more Talent details for that Player
NOTE : NuN does not try to gather this information automatically for Party/Guild members.

- fix to try and minimise the display of Contact tooltip details when hovering over General items with the same root name



Changes in v6.43.20400 from v6.42.20400
---------------------------------------

- fix to note creation from Player name chat links

- can now use the NuN Modifier keys create notes directly from the AH Item buttons
i.e. the small square Item ICONS - and NOT the long main AH button with the item price, etc.

- correction to NuN Tooltip positioning when 'extra' Shopping Tooltips are displayed

- item notes from now on will ignore item Unique Identifiers, enchants, etc.
(See Section 05 "Item Notes" in the Readme for more details)




Changes in v6.42.20400 from v6.41.20400
---------------------------------------

- UberQuest & QuestGuru compatibility update



Changes in v6.41.20400 from v6.40.20300
---------------------------------------

- New Option to hide NuN Notes and Tooltips for Ignored players
(Note: this only hides ignored player notes in the Note browser frame - you can still open that players note via slash commands, or Microbuttons)
(Note2: only the NotesUNeed tooltip is hidden, not the Blizzard Game Tooltip)

- small compatibility changes to SendMessage hooks (hopefully more compatible with TellTrack

- allows manual entry of names beginning with special "accented" characters e.g. , , etc...
(NOTE : Names beginning with these types of characters are sorted by the game to appear AFTER "Z" alphabetically)

(BETA Functionality)
- If you send a note to someone who already has a note with the same name, then the recipient will be shown a Warning Dialog box allowing them to choose whether they want to Replace their existing note, or cancel receipt of the note and keep their original version instead.
There is now also a third option allowing the sent note to be merged with the existing note by "ALT-Clicking" on the Replace button.
When notes are merged, then the newly sent text will be appended to the end of the existing note's text. Currently, other values such as those populated in DropDown boxes will still be set according to the received note, and will replace old values in the original note.



Changes in v6.40.20300 from v6.39.20300
---------------------------------------

- correction to maximum number of characters allowed in the note edit box



Changes in v6.39.20300 from v6.37.20300
---------------------------------------

- disambiguated between Player and NPC tooltips when mousing over the WorldFrame

- increased the maximum size of notes



Changes in v6.38.20300 from v6.37.20300
---------------------------------------

- NotesUNeed will now remember Pinned Tooltips between sessions

- small fix to incorrect Pinup tooltip checkbox status if one is already showing when checked

- fix to problem with Slash commands for Sending of notes
Should now be able to send NotesUNeed notes, or broadcast to channels via Macros/Scripts

- small update to Drop Down box initialisers



Changes in v6.37.20300 from v6.36.20300
---------------------------------------

- Bleh!  Had to change the shortcut key for Saving notes to <Alt>-S
This should re-enable normal shortcut keys for cutting / pasting



Changes in v6.36.20300 from v6.35.20300
---------------------------------------

- the "[]" hyperlink button functionality can now be restricted to output individual hyperlinks, by highlighting them in the note text.
So if no text is highlighted, then the functionality is unchanged and all Hyperlinks are "echoed" to the Chat frame where they can be clicked.
But if you highlight individual Hyperlinks in the text before using the button, then only those will be "echoed"

- the "[]" hyperlink button will now also paste hyperlinks in to the chat frame edit box rather than "echoing" to the chat frame, IF the edit box is open

- can now use the <Control>-S shorcut key to save open NotesUNeed notes
This is the most common short key used to save documents in all types of word processors and notepads, and I won't be offering a way to modify it.
I am so used to using <Control>-S to save documents/scripts while writing them, that this has been on my wish-list for a long time ;p

- a chat frame message will now confirm when you manually save a note





Changes in v6.35.20300 from v6.31.20300
---------------------------------------

- can now customise the Player Ratings.
Open up any Player note;
Click on the Player Rating DropDown button;
<Control>-Click on any Player Rating button to change it via 2 dialog boxes : 
 Box 1 allows you to change the Player Rating text
 Box 2 allows you to change the Tooltip text
<Alt>-Click on a Player Rating button to reset it (and the tooltip) to the NuN default value

- compatibility changes to work with the "Black List" AddOn
When customising Player Ratings using the technique described above, then checkboxes will allow you to specify whether that Player Rating should also Black List the player;
A further two check boxes allow you to specify whether the black listed player should also be Ignored, or trigger a Warning.
Now when you select that Player Rating for a Player, then they will be automatically be added to the Black List AddOn database.
The Black List reason will be auto populated with the NuN Player Rating and Tooltip text.
If you select a different NuN Player Rating with different Black List criteria, then the Black List details will be updated in the background.
If you select a different NuN Player Rating with no Black List criteria, then the Black List details will be left untouched.
If you remove someone from your Black List, then their NuN Player Rating will be reset to blank if it can detect that the Player was Black Listed from NuN;
i.e. players Black Listed from NuN will have a reason for black listing pre-fixed with a purple NuN !
> Black List AddOn : http://wowui.incgamers.com/?p=mod&m=4926

- the Options Frame is now moveable

- the Options Frame and MicroButtons are now Clamped-To-Screen and can't be 'lost'

- fixed a small graphical problem on the Options frame



Changes in v6.31.20300 from v6.30.20300
---------------------------------------

- small fix to error that occurs when Raid member change



Changes in v6.30.20300 from v6.25.20300
---------------------------------------

- more information now recorded and displayed when auto-noting Party members
When hovering over the "Parties : " label on the Contact note, NotesUNeed will display a tooltip with the following information :
a.) Which of your Alts has partied with that player
b.) How many times that Alt has partied with that player
c.) The date on which that Alt last partied with that player

- Verbose Guild Reporting now 'toned down' a little, and now completely silent when turned off

- fixed a problem displaying the NuN Tooltip when using the "Tooltip" key word in the Contact note user definable buttons

- updated BG detection to prevent party member noting in Battlegrounds where parties can often be random with players from different Realms
(Parties pre-made before entering the BG obviously WILL be noted if the option is enabled)



Changes in v6.25.20300 from v6.05.20300
---------------------------------------

NEW FUNCTIONALITY IN LFM FRAME
- support for NuN Buttons on the Looking For More Frame

- new Tooltip support when mousing over players on the LFM Frame :
NotesUNeed will display an extra Tooltip to show Player Ratings for all party members you have noted



NEW FUNCTIONALITY TO COLOUR TEXT
- can now select your own text colours in notes via colour selection buttons on the note frames.
There are 5 Preset colour buttons, and one Custom colour button for opening the Colour Picker Frame to choose any other colour.
So simply, highlight the text you want to colour in and click on the colour you want.
You MUST highlight the text you want to colour by USING THE MOUSE.
(i.e. text highlighted by holding down the <Shift> key and using the keyboard arrows will not be coloured by NuN)

- Preset colour buttons
1.) Left click to apply the colour to highlighted text
2.) Right click to open up the colour picker and choose your own preset colour choice
3.) <Alt>-Right click to reset the preset colour to its default value

- Custom colour button
1.) Left click to open up the Colour Picker Frame and choose a colour.
	NOTE that the colour is NOT applied to the text until you click the "Okay" button.
2.) Right click on the Custom colour button to Toggle the display of the colour Tags in the text. This ability should be useful when trying to see
	NOTE : YOU CAN NOT USE THE BUTTONS TO COLOUR TEXT WHILE SHOWING COLOUR TAGS !!!
The Custom colour button will remember the last colour you chose (even between sessions).

- improved native support for manually entered colour codes
i.e. you can now type in your own colour code tags and they will be applied when you save the note
(e.g. "colour the word |cff0000ffblue|r with the colour it describes")
General type Note names can also be coloured by manually applying colour tags.

PLEASE SEE THE "Whatever you do DONT READ THIS.txt" FILE FOR MORE DETAILS



NEW FUNCTIONALITY FOR NOTING ALTS
- can now include the names of People's Alts in their Tooltip.
Their Note text needs to include the name of their Alts in the format :
 <ALT:Altname1>
 <ALT:Altname2>
 etc.

- with the Guild Frame Open, and a Players Note open, you can specify their Alts by :
<Alt>-Clicking on the other Guild member NuN Note symbols for Alts of that Player
This will paste the ALT's name in to the currently open Player note, where it will then be visible in the Tooltip for that Player



MISCALLANEOUS
- new Text box on the Transmit Note frame detailing the delay between messages, and allowing easy update of this value
NOTE that you have to press <Enter> or click on Transmit for the value in this edit box to be saved.
(Not all messages are sent with a delay e.g. Whispers, Party, etc.)

- included a checkbox for toggling NuN Microbuttons on the NuN Options frame

- Cosmos Feature Frame button for accessing NuN Options

- NuN Tooltips will now try to inherit the Alpha settings of the Game and WorldMap Tooltips to try and be compatible with other AddOns that change these settings

- fixed a problem when removing friends

- fixed a problem displaying Abandoned Quests in Red text

- code clean up and greatly reduced the number of Global and Local Variables







Changes in v6.05.20300 from v6.03.20200
---------------------------------------

- NuN /who information requests improved, and now silent
(	Also improved compatibility with AddOns using specialised Who Libraries;
	Although no guarantees in this case, so remember "/nun -restrictwho"	)

- Adjusted the Guild auto-noting

- Anchors for the Quest log note symbols now positioned on the left

- Improved compatibility with AddOns that change the Quest log
(Only tested with Bayi's Extended QuestLog)

- Corrected the positioning of the NuN Options Frame (where UI Scale is large)



Changes in v6.03.20200 from v6.02.20200
---------------------------------------

- Guild notes should only be created when the Option is turned on !



Changes in v6.02.20200 from v6.01.20200
---------------------------------------

- as some people are still seeing the WhoFrame, I have changed this functionality.
You shouldn't see when NuN "/who"s somebody, but at worst now, you should only see Chat Frame /who information.

- as a last resort, anyone still having trouble with the /who command can use the following slash command
/nun -restrictwho
This command will stop NotesUNeed from automatically requesting Who information. The Who button in Player notes should still work for manual requests.
(There is also an "/nun -alternatviewho" command available that people can use to modify the NuN Who without disabling it)

- the following slash commands now report status.
/nun -delay [number of seconds]		-- [number of seconds] is optional; If ommitted then the current value will be reported.
/nun -restrictwho
/nun -alternativewho


	
Changes in v6.01.20200 from v6.00.20200
---------------------------------------

- can now hold down the <Alt> key in order to show the full NotesUNeed tooltip when Mousing Over other players in the 3D world.
i.e. holding down the <Alt> key temporarily cancels the "Minimise MouseOver Target Tooltips" Option.
NOTE: pressing <Alt> won't immediately change the NuN Tooltip from a minimised to a full tooltip on its own. You will have to refresh the Game Tooltip by moving the mouse away, and holding the <Alt> key down when you Mouse Over that target again.



Changes in v6.00.20200 from v5.59.20200
---------------------------------------

- NEW Button on the Options Frame to capture User Defined Mouse & Keyboard modifiers to use when creating notes from Items / Links.
Simply Left/Right Click without any modifier keys to choose which Mouse Button to use.
Hold down required Modifer Keys & Click to Save the specific keyboard Modifiers to use.
Modified Left  Click : Records left or right keyboard buttons as the same modifier key
Modified Right Click : Records left and right keyboard buttons as different modifiers
Default is still <Alt>-Left Click
The Text on the Button itself reflects what the mouse button & modifier combo is currently.
SEE THE README.TXT FOR FURTHER EXAMPLES OF HOW TO USE THIS BUTTON

- Player Rating via the Right click context menu has a new addition.
The first button is an option to open a NotesUNeed note for that Player without "Rating" them.
The other rating options are still present and will assign a Player rating without opening a note.
All the options will create a note for the Player in question if no NotesUNeed note already exists.
If you hold down the <Alt> key while choosing a Rating, then the NuN Note will also be opened.

- Added a Drop Down box listing all your Alts to the Quest History frame;
So that you can now browse the Quest History for any of your Alts no matter which one you have logged in with.
Obviously, you will have needed to have logged in to these Alts at some stage with a version of NotesUNeed enabled.

- More information about Guild, Race, Class, and Sex should be gathered automatically without needing you to manually select details.
Some information requires you to have Partied with, or Targetted people when creating the note;

- New slash commands for Sending/Broadcasting notes :
/nun -sendG  "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]		-- sends General type note text
/nun -sendGF "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]		-- sends General type note as Formatted text
/nun -sendC  "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]		-- sends Contact type note text
/nun -sendCF "NOTE_NAME", "SEND_METHOD"[, "SEND_PARAMETER"]		-- sends Contact type note as Formatted text
 where -
 "NOTE_NAME"		= the name of the note or note title
 "SEND_METHOD"		= how to send the note e.g. "GUILD", "RAID", "WHISPER", "CHANNEL", etc.
 "SEND_PARAMETER"	= Optionally required (i.e. who to WHISPER to -OR- the Channel ID/Name)
NOTE: using any of these slash commands will close any currently open note.

- Added a delay between lines sent when Broadcasting/Transmitting notes to other Players on Channels.
Default delay is 0.33 seconds (i.e. roughly 3 lines a second)
Use slash command "/nun -delay <#_SECONDS>" to change the default delay time

- The "Who" information button should now work with 1 click

- Added Options to automatically maintain Notes for all Guild Members.

- There is a verbose option for Guild noting, and NotesUNeed will report the total number of members (and the number currently online)
NotesUNeed will also note the names of new members, or members who have left the Guild since the last changes NotesUNeed recorded.

- various bug fixes including a problem with the Mass Delete functionality, and made sure it tidies up after itself

- various changes to clean up the code

Version 6 Credits
_________________

All the following players for their suggestions, and testing feedback : 
Hristo, drubear, acapela, SiNNeR, Nihlo, PeterPater, stgn, AlexejK

...and a poke in the eye for those who said they'd test, but didn't ;p




Changes in v5.59.20200 from v5.59.20100
---------------------------------------

- 20200 compatibility changes and update




Changes in v5.59.20100 from v5.58.20100
---------------------------------------

- replaced the Current PvP Rank box with an Arena Rank box



Changes in v5.58.20100 from v5.57.20100
---------------------------------------

- added a key binding for toggling the last opened NotesUNeed pin-up tooltip

- added the following methods for Note Transmission/Broadcast :
OFFICER : can now send notes to the Guild Officers channel in addition to the GUILD channel
RAID-WARNING : Raid warning messages
BATTLEGROUND : support for Battleground Raid groups in addition to the normal RAID channel

- fixed a small description problem for one of the key bindings



Changes in v5.57.20100 from v5.56.20003
---------------------------------------

- just a toc update(with a couple of small changes to Chat frame hooking)
THIS VERSION SHOULD BE TREATED AS A BETA AS NO TESTING HAS BEEN CARRIED OUT ON IT.

If you don't believe this version of NotesUNeed is working then please report the following : 
1.) The exact error message and line number - enable WoW error reporting
2.) How to repeat the error? Or some description of when it happens? 
e.g. when you log in, or when you click on a particular button, or when you complete a quest, etc.
3.) Which NotesUNeed Options you have enabled
4.) The list of other AddOns you have installed

If possible, it would be helpful for people to try the following :
a.) Try playing with NotesUNeed as the only enabled AddOn to see if the error still happens
b.) If the error goes away, then it is a compatibility issue with another AddOn. It would be extremely helpful if you can enable AddOns individually until the error happens again, so that we know which other AddOn, NotesUNeed is not compatible with. You may be able to make educated guesses at this; For example, if the error is happening when you Complete Quests, then it is likely to be an incompatibility problem with another Quest related AddOn.
c.) If the error does not go away, then I definitely still need all the information from points 1, 2, and 3 above.



Changes in v5.56.20003 from v5.55.20003
---------------------------------------

- small change to the behaviour of the MapNotes NotesUNeed Tooltips
The NotesUNeed Popup list of Notes will now disappear immediately when your Mouse leaves a MapNote.
If you want the List to stay Open so that you can view the NotesUNeed Tooltip for individual notes, or Click on the Note to open it, then hold down the <Control> key and the NotesUNeed Popup list of notes will stay open.

- small change to Quest Recording to make sure Notes are created more promptly when accepting quests

- double check to prevent a rare error when logging in with other Quest AddOns installed



Changes in v5.55.20003 from v5.50.20003
---------------------------------------

- added basic ability to change the font used in Edit Boxes where you type text
Basically, I have supplied an alternative font that can be used in game by Ticking the new "NuN Font" Check Box Option.
The supplied font is the free Vera Sans Mono (True Type) font - a monospaced font that simplifies text allignment e.g. in Script style notes.
If you want to use your own Font when editing notes, then simply copy your font in to the following directory and re-name it to "NuN.ttf"
Interface\AddOns\NotesUNeed\Artwork

- corrected a problem with the Friend/Ignore list functionality when targetting the individual, and now make sure note symbols are updated immediately

- double checks now in place to make sure you can NOT delete Friend/Ignore Notes if using NotesUNeed to automatically maintain Friend/Ignore Lists



Changes in v5.50.20003 from v5.47.20003
---------------------------------------

- fixed the Quest Log problems that were broken by a recent Blizzard Patch

- change to MapNotes-NotesUNeed Tooltip Functionality :
Previously there would be delay when displaying the MapNotes-NotesUNeed Popup frame which would prevent it from closing when your mouse leaves the MapNote, therefore allowing you time to click on the NotesUNeed button to open the Note - this delay would also prevent the Popup frame from closing if you moused over another MapNote - this affect was also deliberate to allow the user to access the NotesUNeed button;  i.e. the button would disappear if the route of the mouse from the initial MapNote to the NotesUNeed button passed over another MapNote.
Anyway to cut a long story short, I have now changed this functionality. There is still a delay leaving the NotesUNeed buttons available to click when your mouse leaves a MapNote - But the tooltip and NotesUNeed Popup frame will refresh immediately when you mouse over any other MapNote.
If you are having trouble clicking on a NotesUNeed Popup button for one MapNote, because you can't avoid mousing over other MapNotes to get to it - then hold down the <Control> Key,  and Mousing over other MapNotes will be suppressed.

- Doh! Forgot to add the Paladin/Shaman classes that are now available to Horde/Alliance respectively

- fixed the NPC Information fetching routine to make sure Professions are fetched correctly
(Note, I have not tested with other GameTooltip Modifications installed - the code still relies on the Profession being recorded on the second line of the Tooltip, so if another AddOn has hidden or moved this information to a different line of the tooltip, then I don't have any plans to address that as a NotesUNeed issue; There could just be too many options for me to cater for given the number of Tooltip AddOns available.)



Changes in v5.47.20003 from v5.46.20000
---------------------------------------

- updated the Race and Profession drop down boxes to include Burning Crusade options
(I've been very lazy and just added the new races/professions after the last entries in the drop down boxes, rathter than re-arranging in alphabetical order - it means I don't have to write a conversion routine to update old notes, or during note exchange between different language clients)
NOTE : Sending of Contact style notes to users of older versions of NotesUNeed is unsafe where the Contact references one of the new Races/Professions



Changes in v5.46.20003 from v5.45.20000
---------------------------------------

- toc update

- only reset the map when a QuestWatch_Update functions confirm that an objective has been completed, to cater for other AddOns that call the function continuously

- Blizzard's Patch 2.03 should fix all other WoW v2.xx Blocked Action issues



Changes in v5.45.20000 from v5.42.20000
---------------------------------------

- NEW Microbutton functionality.
1.) can now quickly access Quest History notes by Right-Clicking on Search Microbutton (i.e. the Magnifying glass)
2.) can now quickly access the list of General Notes by Alt-LeftClicking on the Search Microbutton

- Chat Frame Hooks changed which should fix problems connected to Pet Bars and handling, when pets are summoned during combat

- With a Mob/NPC targetted, using either the Player or General Microbutton will open/create a note for that Mob/NPC

- when noting completion of Quest objectives, Zero messages will be ignored as they aren't useful and just take up space

- fixed the bug of the Save button not working for general notes if still editing the title (withouth ever having moved the text cursor to the main body of text) Hopefully that should fix the problem as it was reported. (Thanks to Giddily for the Pic. ;)



Changes in v5.42.20000 from v5.40.20000
---------------------------------------

- updated more function hooks to ensure secure hooking is used where indicated by function attributes. Especially for PaperDoll frame, but also even if no visible errors were noted previously.
(Should fix the Blocked Action error when using Items directly from the Character sheet)

- fixed the ability to create notes from the character sheet
NOTE : ONLY need to <Alt><Left Click> on Character sheet items to create/paste in to NotesUNeed notes.
(i.e. no need to use the <Shift> key on Character sheet items, and users of the Alternate version of NotesUNeed should also simply <Alt><Left Click>)

- fixed a small issue when clicking on Ignored players in the Social frame to make sure any open Contact note is updated - as per functionality on the other pages of the Social frame.

- fixed a small bug when deleting Quest History entries by Right Clicking and confirming deletion

NOTE: Again, PetDismiss and Duel errors can't be fixed (as far as I know) without removing the Right click Player Rating functionality; Sorry, but I'm not willing to remove the functionality atm, only to have to put it back in again when Blizzard fix the issues in their next patch. So check the "NotesUNeed and WoW2.xx.txt" file included in the archive - or check earlier Patch notes below for more details.



Changes in v5.40.20000 from v5.30.20000
---------------------------------------

- NotesUNeed will now record the locations where Quest Objectives/Items were achieved/dropped if you are auto-noting Quests
For example if a quest is called "Kobold Camp Cleanup" and you are auto-noting Quests, then NotesUNeed will record 2 notes for the Quest.
One called "Kobold Camp Cleanup" which stores the quest details from each stage of the quest;  And one called "Kobold Camp Cleanup:Objectives" which will record your Map locations when objectives were completed / quest items received.
Character specific details of when you Accepted, Completed and Handed In a quest on a given character is still only available when browsing QuestHistory while logged in as that character - by viewing the toolip when mousing over the list of quests after selecting to Search for NotesUNeed QuestHistory from the Options frame.

- as a result of some old changes in previous versions (forced by changes in WoW), new line characters (carriage returns) now use up 2 characters in the text box.
Because of this, the number of characters being reported in the NotesUNeed edit boxes has not been an accurate guide,  but this has now been fixed.


NOTE: it seems that the WoW Patch 2.02 may never arrive, so included here are further compatibility changes for WoW Patch 2.xx

- fixed the Blocked Action issues when using/disenchanting bag items

- PetDismiss problems have been fixed in the latest Burning Crusade Beta, and there doesn't seem to be a way for me to fix them until the Blizzard patch is released (without removing the Right Click Menu Player Rating buttons).
The problem can be avoided by NOT using the NotesUNeed Right Click Player Rating functionality. (Sadly, you can't even roll your mouse over the Player Rating button in the Right Click menu, so the safest way to close a Right Click menu is to use the Escape key - you can still use all the other options on the menu)
If you do get the issue, you can use the following script to cleanse your execution path :
/script ReloadUI();
The above script is case sensitive, and allows you to re-load your User Interface without having to completely log out and back in again

- Duelling Blocked Action issues have not been fixed in the latest Burning Crusade Beta. But the slash command still works.
(If anyone can explain to me why the Duel function is Secure I'd be interested to hear? I've been struggling to come up with a way in which I could cheat during a battle/raid by challenging people to duels ^^)

Basically, I'm hoping that once Blizzard release a Patch, then the only permanent problem will be with Duelling from the Right Click menu - and as people can still use the Slash Commands, I'm not gonna worry about it.

Please READ the "NotesUNeed and WoW2.xx.txt"  file included in the archive/zip file for NotesUNeed v5.40.20000 for any further details, clarification. (Or if you receive Unfinished String errors)



Changes in v5.30.20000 from v5.26.11200
---------------------------------------

- WoW Patch 2.xx Compatible Beta Version (Awaiting some Blizzard bug fixes in v2.02)
IF YOU HAVE RECEIVE 'UNFINISHED STRING' ERRORS WHEN LOGGING IN TO WOW YOU MUST READ THE FILE "NotesUNeed and WoW2.01.txt".
The new version of WoW can object to notes made in earlier versions of WoW. Sorry, but there is nothing I can change in the code to fix this. Its just another one of those undocumented changes to the way WoW treats text strings in the SavedVariables files,  and if you suffer from this error, you should read the above file, that is included in the zip file.

- NotesUNeed will no longer try to target Players when you create new notes or use the "Target Info" button, so target someone manually before using.

- NotesUNeed will now trigger a User Interface Reload when you use the BackUp,  or Restore functionality

- There are now 3 tiers of MapNotes tooltip support :
1.) The original full support. No longer works with old versions of MapNotes as they will contain ZoneShift errors after the recent patch.  Full support including the ability to merge notes, etc. is only available with "MapNotes (Fan's Update)"
(Including the version now included with Cosmos)
2.) Note making support. This level of support is for MetaMap. Merging of Notes to link several NotesUNeed notes to one MapNote is not possible, but you can still create basic MapNotes via the NotesUNeed buttons.
3.) Basic tooltip compatibility. This is basically aimed at any other Map noting AddOn such as CTMapMod, and allows the display of a NotesUNeed tooltip alongside the MapNote tooltip where the NotesUNeed note name is identical to the title of the Map note.



Changes in v5.26.11200 from v5.25.11200
---------------------------------------

- Important Bug Fix for Right Click Menu Functionality



Changes in v5.25.11200 from v5.10.11200
---------------------------------------

NOTE: v5.25.11200.A  is an Alternate version where the short cut key for creating notes when clicking on Items/Hyperlinks has been changed from <Alt><Shift>-Click to use <Control><Shift>-Click instead. This is mainly for players using different language clients where the pressing of <Alt> and <Shift> would result in a language change, rather than NotesUNeed functionality.

- Added 60% French Localisation

- Added some more Player Rating Options, such as 'KoS' for other Faction players, and generic Star Ratings to simply score your opinion of other players out of 10

- Added new Right-Click Menu options for Friends/Chat/Target/Party,  enabling the quick change of a Player Rating.
(If no note exists for a Player when you choose a Rating, a new NotesUNeed note will be created for that Player - the note will NOT be opened; Only created in the background, and your Rating of that Player saved)

- New "Show Chat Tags" option. When checked, Chat messages/emotes from Players you have noted with NotesUNeed will be pre-fixed with "<NuN>". If you have saved a Player Rating for that player, then it will also be included in the Chat Prefix. For example, if you have noted another Player as a 'Ninja', then the Chat prefix will read "<NuN:Ninja>"



Changes in v5.10.11200 from v5.00.11200 - Minor Release
-------------------------------------------------------

- Right clicking on Quest History now shows a Prompt window asking if you wish to delete the History record.
(This makes sure you can always delete history, even if you don't have the original quest note)

- Change to make sure Map Note links are up to date when opening the World Map

- Minor MetaMap compatibility changes



Changes in v5.00.11200 from v4.53.11100 - MAJOR RELEASE
-------------------------------------------------------

BACKUP & RESTORE FUNCTIONS
==========================
- added new "Backup" and "Restore" options. This functionality is kept under a second AddOn/folder name of "NotesUNeed_Backup", which allows it to be Load On Demand.  See the 'Backup and Restore Functionality' section of the Readme.txt file for more details.


IMPORT & EXPORT FUNCTIONS
==========================
- New Export button available on the Notes Search/Browser frame. So search for the notes you want to Export, so that they appear in this frame, and then click on Export. You will be prompted for a name to call the record set you are exporting. Confirm export of the records, and you will be informed of how many notes were exported in the Chat window.
The exported records will be recorded in the file NotesUNeed_Export.lua, in the same SavedVariables folder as your normal NotesUNeed.lua database file.
Once you have created a set of records, then the Export button can ONLY be used to add more notes to that record set.
If you want to delete the records you have exported and create a completely new record set with a different name, then you must use the Slash command "/purgeexport". This clears the NotesUNeed_Export.lua file in the saved variables directory, and you can then use the Export button to create differently named sets of exported notes. (Obviously if you want to save a set of exported records, then you must take a physical copy of the NotesUNeed_Export.lua file, before using the "/purgeexport" command.)
The Export function is kept under a second AddOn/folder name of "NotesUNeed_Export", and is Load On Demand.

- In order for another user to Import the notes you created, they need to copy your NotesUNeed_Export.lua file in to the NotesUNeed AddOn folder on their computer. (i.e. NOT their SavedVariables folder).  In order to do this, they will have to replace the existing NotesUNeed_Export.lua file that already exists in their AddOn's folder.  i.e. \WoW\Interface\AddOns\NotesUNeed\NotesUNeed_Export.lua

- New Import button available on the Options frame. This will only be available for use if the user has a NotesUNeed_Export.lua file in their AddOn directory which contains notes available for Import. NotesUNeed_Export.lua is blank when you first install NotesUNeed.
When the user clicks on the Import button, they will be prompted with a general name identifying the set of notes available for Import, together with the number of records that will be imported, and will be offered the choice of continuing to Import, or cancelling the action. If they click on Import, then they will receive a message in the chat window informing them of the number of records that were imported.
NOTE: Imported records are all saved at Account Level, and will overwrite any notes that already exist with that name.
Please see the Import/Export section of the Readme.txt file for further details

- NOTE : You can't export Contact notes or Quest History. Only General Notes.


GLOBAL FRIEND/IGNORE LISTS AND AUTO-NOTING
==========================================
- Completely re-written the optional Global Friend/Ignore List Maintenance functionality
So for example, when you ignore one person on one Alt, then NotesUNeed will automatically try to ignore that person when you sign in to another Alt. By default NotesUNeed will send a message to the Chat frame informing you of when it is adding/removing Friends/Ignores. New "Silent Mode" option is available, if you wish to suppress the extra messages created when NotesUNeed adjusts your lists.
You may find that NotesUNeed continues to try and adjust a Friend/Ignore when you log in - this is usually caused by trying to ignore someone who is not online, which therefore fails, and NotesUNeed will try again next time you log in. There are several aspects of this issue to consider :
1 - You can use "Silent Mode" so you don't have to see the messages
2 - If you prefer not to use "Silent Mode", so you can keep an eye on what's happening, but you are tired of trying to ignore someone who never seems to be on line, then check the extra Messages NotesUNeed is displaying to see the name of the Player NotesUNeed is trying to ignore, and do one of the following :
    a.) sign in to your Alt that IS ignoring the named player, and stop ignoring them
    b.) use the new "/nun -i <Player Name>"  command to force NotesUNeed to stop trying to ignore the named player
3 - sometimes your NotesUNeed friend and ignore lists can be corrupted by Deleting one of your Alts which had Friends/Ignores that your other Alts were not aware of yet  OR  when a character on one of your lists is Deleted from the Server, and NotesUNeed keeps trying to refer to them.
In these cases, you will have to use the new "/nun -i <Player Name>" function.
When you use the "/nun -i <Player Name>" option, then if you log in to an Alt that IS ignoring that Player, NotesUNeed will remove them from that Alt's Ignore list automatically.
Note that just in case your Friends data should become corrupted, there is also a corresponding "/nun -f <Player Name>" function which will force a player to be removed from the NotesUNeed friends list.
If you wish to reset your Friends/Ignore lists to the current Friends/Ignores of the Alt you are currently logged in to, then there is a third slash command option "/nun -resetlists"
If using NotesUNeed to maintain Global Friend/Ignore Lists, then you will be unable to Delete Notes for people on these lists.
(Please note that due to the reasons mentioned earlier, it may be possible that you won't be allowed to delete a note if NotesUNeed thinks they are a Friend or Ignore, even if that person is not currently on your Friend / Ignore list - use the "/nun -i..." or "/nun -f..." slash commands to correct if needed)

- Changed the functionality of the "Auto-create note when Adding Friends/Ignores" option. It will no longer ensure that ALL your Friends and Ignores have notes, and will only do what it says, which is to make sure a note exists for an individual when you add them as a friend or ignore.
This option is mandatory if you are using the new option to use NotesUNeed to maintain global Friend/Ignore lists. This option will be automatically checked if you use NotesUNeed to maintain global Friend/Ignore lists, and you will be unable to un-check it.


CHANGE TO AUTO-LEVEL-UP NOTING
==============================
- if you have turned on the ability to auto-create notes for your own character, then when you level up, NotesUNeed will create a new General style note with a name based on your character's name and the level they have reached. For example, if you have a character called "Bigbadguy" and you have just reached level 52, then NotesUNeed will create a note called "Bigbadguy 51 - 52", and this note will contain the date and time when you levelled, plus your characters location on the map, and the Stat increases that they have been rewarded with for reaching that level.


MISCALLANEOUS
=============
- compatibility update to support upcoming release of "MapNotes (Fan's Update)"
MapNotes (Fan's Update) supports the making of notes on Atlas  and/or  AlphaMap Instance/Battleground/World Boss maps, plus movable notes, search feature, bug fixes and more.

- Hyperlinks pasted in to notes will now be inserted at the Cursor position, rather than added to the end of the note

- Improved support for Enchant Links in the text. Note that you can create Enchant notes, or past Enchant links in to your notes by Shift-Alt clicking on the Enchant Links within the Chat Frame. Enchant Links will now be copied to the chat frame when you use the "[]" (Hyperlinks) button in the top right of General Note frames; And Enchant Links should now Transmit properly to other users when you send them notes. Note that as part of the changes to support Enchant hyperlinks, all links are now transmitted to other users on seperate lines.
(Sorry, no support for directly pasting from the Enchant frame, but you can Shift click Links in to the Chat frame, and then Alt-Shift click the link in to NotesUNeed notes)

- Fixed a bug when searching Player notes by Class or Profession

- automatic creation of Party Notes is now suppressed when in Battlegrounds, as many if not all BG players (in AV especially) will be from different Realms.

- prevent the creation of Contact notes with the name "Unknown" (or localised equivalent)

- Added a 'Mass Delete' button to the Note Browser frame, so you can search/filter for notes you want to delete, and remove them more easily

- Change to the auto-Map Noting of Quest NPCs to ensure more reliable recording




Changes in v4.53.11200 from v4.52.11100
---------------------------------------

- .toc update for latest WoW patch
- double check that should fix Faction problems for Horde players 'stuck' in Alliance mode


Changes in v4.52.11100 from v4.51.11100
---------------------------------------

- Fixed the compatibility issue with MetaMap
- Made sure the NotesUNeed map tooltip closes when the map is closed


Changes in v4.51.11100 from v4.50.11100
---------------------------------------

- Fixed the 6169 error which can happen when showing the tooltip


MAJOR RELEASE - PLEASE read about the changes made in this version

Changes in v4.50.11100 from v4.12.11000
---------------------------------------

Fixed Rare Crash On Exit Bug
----------------------------
- Fixed the rare Crash On Exit bug and proved beyond all reasonable doubt that it is a Blizzard bug, and NOT a NotesUNeed bug ;p
Proved by the fact I can manually enter new notes in other note taking AddOns that will cause WoW to crash. As a result of the solution I have implemented, you should not use the following 3 character pairs in your notes, as NotesUNeed will interpret them as special characters :
"n"
"s"
"q"
For more technical details plus a special caveat, see the secion called "Crash On Exit Solution" section of the Readme.txt file.
DUE TO THIS CHANGE, TRANSMISSION OF FORMATTED NOTES TO USERS OF EARLIER VERSIONS OF NOTESUNEED MAY YIELD UNPREDICTABLE RESULTS !



Send Note Changes/Enhancements
--------------------------------------
- Added the ability to send notes to Chat Channels via a new choice and Drop Down box in the 'Send Note' frame. Please Note the following :
1.) When transmitting Un-Formatted notes to a Channel, the NotesUNeed prefix will NOT be transmitted, and NEITHER will the notes name/title. So if you want the notes name to be tranmitted, then you should repeat it at the top of the note's text. This means you shouldn't spam public channels with unnecessary details when you were just trying to broadcast a WTS list to the Trade channel for example :)
2.) You are not necessarily subscribed to the channels listed in the 'Send Note' frame and/or activity on a channel may not necessarily be reported to the default chat frame, so if nothing seems to happen when you 'Transmit' to a channel, please make sure you have 'Joined' that channel, and that its Output is reported in the Chat frame you are looking at.

- Fixed a minor problem where NotesUNeed could not include embedded Informant Tooltip information in notes sent to other users/channels.

- When transmitting notes, NotesUNeed now leaves WoW to define the default languages as problems were reported on other language clients

- Fixed a small bug in Error Log notes when non-critical errors happen during the transmission of NotesUNeed notes



Changes to Text Search Functionality
------------------------------------
- Changed the Text search functionality. (Also fixed an issue where the search could be ignored).  Basically, text searching is now case-insensitive.  However, if you need to carry out a Case-sensitive text search, then open the note browswer frame, enter the text you wish to search for and <RIGHT>-Click on the Search button.

- Added a label beneath the text search box to show more clearly when you have carried out a two-tiered text search. See the "Text Searches" section of the Readme.txt file for more details.



Changes to MapNoting Functionality
----------------------------------
PLEASE NOTE THIS VERSION OF NOTESUNEED HAS BASIC SUPPORT FOR ANY MAP NOTING ADDON, AND CAN DISPLAY NOTES WHENEVER THE NAME OF THE NOTE AND THE FIRST LINE OF THE TOOLTIP ARE IDENTICAL

- Added support for AlphaMap to allow the display of merged map note lists.  This has required a small change to the way that the WorldMap is displayed, and it may now be possible for the user to see certain windows over the WorldMap. e.g. the Titan Panels

- Enhanced the MapNotes support. NotesUNeed will now try to create relationships between NotesUNeed notes and MapNotes with the same name. It will do this when you log in, and after you create/edit MapNotes, or create/edit NotesUNeed notes. Up to 5 NotesUNeed notes can be related to one MapNote. For example, if you want to link the NotesUNeed notes "Note A", "Note B", and "Note C" to a MapNote on the map, then create a new note with the mouse as usual (OR change the name of an existing note), and specify the new name of the note as "Note A | Note B | Note C". NotesUNeed will detect that 3 NotesUNeed notes are linked to that Map note. i.e. specify the note names separated by " | " (space, pipe symbol, space).  After a link has been created, then the map note title can be edited to something else if you like and the link will remain (but will not be automatically recreated if anything should break the link, like manual deletion - see next note )   This feature means that you can now manually link NotesUNeed notes to any MapNote you like :)

- Small change to the way the buttons work in the merged map note lists. A normal left click will now open the note; But Alt-Right clicking is still required to delete the relationship between the NotesUNeed note and the MapNote. (N.B. : if you don't want NotesUNeed to automatically re-create the relationship, then you should add an extra space to the MapNote title text, or edit it to be slightly different to the NotesUNeed note name (or change the NotesUNeed note title)

- Fixed an issue with more recent versions of MetaMap where the Merged NotesUNeed Map notes frame would disappear immediately, rather than allowing the user time to inspect the different NotesUNeed notes associated with that Map note.

- Updated the MetaMap noting support for German Clients. The correct zones should be detected again now.

- Fixed an issue when deleting notes in MetaMap, which would cause the relationship between the remaining Map notes and NotesUNeed notes to be corrupted

- Added the ability for NotesUNeed notes to maintain their relationship with MetaMapNotes after a MetaMap Zone Shift has been executed. (Minimal testing as MetaMap's ZoneShifting was falling over)

- Fixed a problem when the user tries to merge more than 5 NotesUNeed notes in one Map Note



Miscallaneous Changes/Fixes
---------------------------
- Added support for TipBuddy ( Please don't complain about slight overlapping of Rank symbols with the NotesUNeed tooltip - I have only so much time before I die ;p  )

- Added the ability to Right-Click on notes in the Note browser frame to directly toggle the Pin Up Tooltip for that note. Left-Clicking still toggles the Note itself, and Shift-Clicking will paste the notes name in to the Chat frame edit box, or another open note.

- Pinned up tooltips will now be automatically updated if you alter and save their underlying note

- Updated the Sex determination code, so player and NPC sexes are correctly determined again

- Removed a check on the number of 'carriage return' characters in notes as more seem to be supported by the WoW Edit boxes now (although certain circumstances do still seem to result in 'excess' text being replaced by the "..." symbol - this is WoW edit box functionality, so please don't complain to me ;)  )

- Fixed a problem when noting NPCs in BattleGrounds which started after patch ?? (Especially with Auto-MapNoting turned on)

- Various small changes for code clarity/efficiency




Changes in v4.12.11100 from v4.12.11000
---------------------------------------

- Simply a toc update



Changes in v4.12.11000 from v4.10.11000
---------------------------------------

- Fixed another compatibility issue with the latest version of MetaMap when making map notes.



Changes in v4.11.11000 from v4.10.11000
---------------------------------------

- Fixed a compatibility issue with the latest version of MetaMap when making map notes.



Changes in v4.10.11000 from v4.01.11000
---------------------------------------

- Added the ability to run NotesUNeed notes as Lua scripts/macros via a new slash command "/nun -x <Note Name>"
- Or use the NuN_ExecuteNote("<Note Name>") function. This function can be used within Notes to link them together and build complex functionality from separate scripts.
- Fixed a bug which was stopping Replacement of the old version of a note, when manually entering an identically named note.
- Stopped the system message spam when transmitting Guild/Party/Raid notes when not in a Guild/Party/Raid
- Fixed a problem with searching for a Note with an Item Link title, when a duplicate note is sent to you
- Added Receipt Logging, so NotesUNeed will keep details of the last 9 Notes that have been sent to you
- Some small changes to stop introduction of a new line to the start of received notes, and try to prevent any possible line duplication



Changes in v4.01.11000 from v4.00.11000
---------------------------------------

- Extended the compatibility fix for the Extended Quest Log AddOn
- Changed maximum note length to 6006 characters. This is a result of an attempt to avoid the rare bug in WoW which can cause it to crash on exit ;p



Changes in v4.00.11000 from v3.21.11000
---------------------------------------

NEW FEATURES IN v4
------------------

The most significant change in this release is the ability to add notes that people send to you, to your own NotesUNeed database.

- Formatted notes sent to you from other NotesUNeed users will now be re-built and added to your own NotesUNeed database
- Both sender and receiver must be using v4.00 or later of NotesUNeed in order to create notes from received data, and the sender must check for the note to be Formatted
- Note that Hyperlinks in notes can be sent OK, but that coloured text can not, so any coloured text in a note that you send will appear as simple white text in the note of the person you send it to.
- Added the option to remove NotesUNeed formatting 'gunk' when sending notes to other players. The receiving player(s) will not be able to add the note to their own NotesUNeed database, but they will see the text of the note.
- Added a new General note type "LUA Scripts".  So you can now keep an organised database of Lua Scripts, that can be listed separately.
- Added a new Drop Down box in the Character note frame where you can specify someone's style of Party play. e.g. Good party member, Ninja looter, etc.  When populated, this information will be displayed in the NotesUNeed tooltip.
- New key binding to open the Browse All Notes frame
- If you have auto noted people you party with,  the number of times you have partied with someone will be displayed in the Note browsing frame
- Added a standard Close button to the top right of the Options frame


CHANGES TO EXISTING FUNCTIONALITY IN v4
---------------------------------------

- Prevented the display of the "Player not found." message, when NotesUNeed tries to ignore a player that is not currently on line.
- WoW version 1.10 has changed something in the way that the ItemRef tooltip works, and due to this NotesUNeed can no longer identify the slot in which equipment belongs, when listing a contact's equipment via the Target Info button.
- Also due to the ItemRef tooltip changes mentioned above, WoW 1.10 broke the population of an Items details when creating notes via <NuN Modifier>-Clicks on Hyperlinks in the chat frame.  NotesUNeed v4 has fixed this, although you may see the ItemRef tooltip flash up briefly on screen, when making notes via this method.
- When you enter the "/nun" command followed by some text, if NotesUNeed can not find a note with the specified name, or a Target with that name on which to base a new note, then the Notes search frame will be opened and any notes containing the text will be listed. You can still type "/nun" on its own to open the Options frame. Basically, this allows you to search for some text in NotesUNeed notes quickly from the command line


BUG FIXES IN v4
---------------

- Fixed a compatibility issue with the Extended Quest Log AddOn.
- Fixed a note overflow error that can occur for repeatable Quests, causing corruption and loss of the NotesUNeed database
- Fixed the error occuring when attempting to create MapNotes in Instances
- Fixed a couple of small German localisation errors
- Fixed the heading in the Send Note frame
- Fixed a potential problem when creating notes from NPCs when the server is slow to respond - simply prevents the display of the error, as I can't fix a slow server ;p
- Fixed the rare 'Crash on Exit' bug introduced in WoW v1.10  This fix has resulted in a maximum note text length of 6000 characters, rather than the previous 5012, but the size of your NotesUNeed database will not increase (unless you make use of this extra space and add to the text of your notes).
- Fixed the problem of NotesUNeed World Map Tooltips not displaying in Instances for users of MetaMap






Changes in v3.21.11000 from v3.21.1900
--------------------------------------

- Simply updated the toc file for latest WoW version 1.10



Changes in v3.21.1900 from v3.20.1900
-------------------------------------

- Fixed the problem of NotesUNeed notes linking to the wrong Map Notes, after deletion of a Map Note
- Fixed a Map Noting reporting error affecting users of MetaMap in locations where /quicknote will not function
- Adjusted Variable Initialisation for people upgrading from v2.50




Changes in v3.20.1900 from v3.16.1900
-------------------------------------

- Full MapNotes functionality now available to users of MetaMap. ( WorldMapTooltip can be scaled from NotesUNeed by clicking on the double-A button in the top right of NotesUNeed frames )
- Improved the ability to "re-link" NotesUNeed notes to existing WorldMap notes containing the name of the NotesUNeed note
- Adjusted Map Noting functionality to display the NotesUNeed note list frame even for single notes.

N.B. - remember that Alt-Clicking on a particular note's button in the NotesUNeed note list frame on the WorldMap will close the WorldMap and open the NotesUNeed note for editing; And Alt-Right Clicking will delete the link between the Map Note and the NotesUNeed note.

N.B.2. - NotesUNeed notes will still display if the WorldMapTooltip text is equal to the name of a NotesUNeed note. So Map Notes created independantly of the NotesUNeed note of the same name, can still cause the NotesUNeed tooltip to display on the World Map.

- Updated the scaling of Frames, Tooltips, and WorldMap Tooltips - you may need to re-adjust your scaling once after installing this update.
- Options Reset will now restore frames to their original positions
- Ensured the "Confirm Save at Account Level" frame is displayed even when trying to save without displaying the note, IF a Realm conflict exists.
- Fixed the display of Realms list in the "Confirm Save at Account Level" frame.


NOTE ON UPGRADING FROM MapNotes TO MetaMap
------------------------------------------
This warning message refers only to the links between NotesUNeed notes and MapNotes.  i.e. where you have used NotesUNeed to merge several notes on a single MapNote, resulting in the NotesUNeed note list frame being displayed on the WorldMap.

You will NOT lose any MapNotes, or MetaMap Notes, or NotesUNeed notes by upgrading to this version of NotesUNeed.  But the database links between NotesUNeed notes and MapNotes are at risk unless you take the following advice.
(As per normal functionality, even if links between NotesUNeed notes and MapNotes have been lost, if a MapNote has the same name as a NotesUNeed note, then the NotesUNeed tooltip will still display on the WorldMap when the WorldMap Tooltip displays.)

The Advice :
If you are moving from MapNotes to MetaMap and you wish to keep links between NotesUNeed notes and MapNotes, then you MUST keep MapNotes installed the first time that you run WoW with MetaMap installed.  i.e. you must follow the author of MetaMap's advice on how to migrate your MapNotes in to MetaMap. However, to ensure that you keep links between NotesUNeed notes and MapNotes, you MUST run both MetaMap and MapNotes at the same time the FIRST time that you run MetaMap; After which, you may uninstall MapNotes and forget about it.  If you uninstall MapNotes, and run MetaMap without it while NotesUNeed is installed, all links between NotesUNeed notes and MapNotes will be lost.  You may find that you can still go back and run MetaMap and MapNotes together to import your MapNotes in to MetaMap, BUT you will NOT be able to recover the links to NotesUNeed notes.
However, if you follow this advice, then you should notice no difference in the information being displayed when you start to use MetaMap, and all MapNotes and NotesUNeed tooltips should display as they did before.







Changes in v3.16.1900 from v3.15.1900
-------------------------------------

- Fixed the Auction House display of the NotesUNeed tooltip
(The display of the NotesUNeed tooltip in the Auction House can appear a little 'dislocated' sometimes. i.e. after viewing an item such as a ring, which has also displayed 2 additional tooltips showing currently equipped items.  Unfortunately, there doesn't seem to be much I can do about this at present, as I don't seem to be able to reliably determine when the extra tooltips are visible or not.  Basically, seems to be another quirk in the Blizzard UI that I can't explain. Anyway, I judge it to be a minor glitch, rather than a bug, so have not spent any more time on it. If anyone has a technical solution, let me know by e-mail please. )




Changes in v3.15.1900 from v3.12.1900
-------------------------------------

- Removed MapNotes version validation; No longer supported by original author so not much point. MapNotes is being updated in Cosmos.
This should remove the constant warning about the MapNotes version if using the Cosmos 1.9 compliant version.




Changes in v3.12.1900 from v3.11
--------------------------------

- Fixed the error when mousing over units on the Minimap (should fix other mouseover errors)




Changes in v3.11.1900 from v3.10
--------------------------------

- Fixed the error messages occurring when viewing Guild Members
- Increased the maximum scale of the Frames to 175%

v3.10.1900 released in response to WoW v1.9




Changes in v3.10.1800 from v3.00.1800
-------------------------------------

- Changed the way that the NotesUNeed tooltip is displayed in relation to the GameTooltip
- Alt Click on the Contact Microbutton to re-open the last Contact Note you had open
- Alt Click on the General Microbutton to re-open the last General Note you had open
- Key-binding to re-open the last note you had open, whether it be a Contact Note or a General Note
- In the NotesUNeed Search/Browse frame, Quests that are in your current character's Quest Log are now coloured Green
- In the NotesUNeed Search/Browse frame, Quests that your current character has abandoned are now coloured Red
- Some minor performance improving changes
- Fixed some minor FrameXML errors being reported, but which had no functional impact

(Tip: Don't forget that Shift-Clicking the Contact Microbutton will create a note for your current target without opening the note; A key-binding also exists for this functionality.)




Changes in v3.00.1800 from v2.51.1800
-------------------------------------

New Functionality in v3.00.1800
-------------------------------

The most significant change this version is integration with MapNotes - please see the MapNotes section of the Readme.txt for a detailed explanation. Currently, only tested with v1800.7 of MapNotes stand alone AddOn.
Highlights for ALL new features are as follows :

- Added the ability to generate MapNotes from Generic NotesUNeed Notes
- Added ability to automatically create a MapNote when noting NPCs.
- Added ability to auto MapNote Quest Giver NPCs when Accepting Quests
- Merge up to 5 NotesUNeed notes in one MapNote; new tooltip style frame displays list of all MERGED NotesUNeed Notes; Mouse-over to view individual NotesUNeed tooltips
- Alt-Left Click on a MERGED NotesUNeed map Note to close the WorldMap and Open the Note for editing.
- Alt-Right Click on a MERGED NotesUNeed map Note to delete the reference to that Note from the Map Note ( This does NOT delete the actual NotesUNeed Note OR the MapNote - it only removes the link between the MapNote and the NotesUNeed note so that the NotesUNeed note is no longer listed against this MapNote. )
- Added ability to scale up/down the WorldMap tooltips
- Can now see NotesUNeed tooltips for your character and party members on the WorldMap or Minimap
- Auto Note creation options are now set to "Off" by default to prevent creation of unwanted notes at first install
- Shortcut Hyperlink access by sending a list of the Hyperlinks within a Note to the Chat frame where they can be clicked upon. New button with "[]" symbols in top right cluster of buttons in Note Frame.
- Added a Shift-Alt Click ability to paste Hyperlinks in to Open NotesUNeed notes. If NO NotesUNeed note is open, then Shift-Alt-Clicking will open/create a note just as in earlier versions, but if a NotesUNeed note frame is already open, then the Item link will be pasted in to the text of the open note. If you have both a Generic Note and a Contact style note open at the same time, then by default, the Hyperlink will be pasted in to the Generic note's text.
- NPC Level "??" noted as such, instead of as -1
- Stopped the attempts to Ignore people who are on an Infinite Ignore AddOn list


Bug Fixes in v3.00.1800
-----------------------

- Adjusted the positioning of many of the tooltips
- Fixed a problem when creating a note for a Quest History entry whose associated Quest Note had been deleted
- Fixed a couple of minor error messages that had no functional impact






A Note on Moving between NotesUNeed Versions
--------------------------------------------

When upgrading to a new Version, or downgrading to a previous Version of NotesUNeed, please completely move/delete the NotesUNeed directory, before installing the alternate version. Do NOT simply rely on Overwriting previous files - for example, v1.11.1800 has an extra German localistion file that has not been designed for v2.xx.1800, and you leave it in place at your own risk. Similarly, if you are moving back to any v1.xx.1800 release from a v2.xx.1800 release, then there is a Bindings.xml file pointing to functions that do not exist in the earlier version.
Unzip overwriting one version in to another versions directory may not remove these extra files, which might cause unexpected errors - so please completely remove NotesUNeed from the Game's Addon folder before installing another version.

(btw, if you have created Account level notes in a v2.xx release and want to be able to see them in a v1.xx release you will have to resave them at Realm level. I am not going to guarantee that it is perfectly safe to move back to v1.xx after creating Notes with v2.xx, but I have found no problems so far, and any extra fields should simply be ignored - resaving Notes may result in the loss of some v2.xx fields and data, which you would no longer be able to see if you moved up to v2.xx again.)






Changes in v2.52.1800 from v2.51.1800
-------------------------------------

- Fixed a problem based on Class Trainer Frame not existing






Changes in v2.51.1800 from v2.50.1800
-------------------------------------

- Fixed the Game Freezing Issue on Login
- Fixed a problem with Quest Stage text being added to an existing Quest Note
- Prevented manual creation of a Quest History entry until a Quest Note is manually saved
- Added the name of the Targetted NPC and current location when accepting/handing in Quests





Changes in v2.50.1800 from v2.04.1800
-------------------------------------

- Improved the Searching feature to allow for text searching within filtered note sub-sets. (Including 2 tiered text search - please see Text Searches section of Readme.txt)
- Added Automatic Party Member Note Creation and count of how many times you party with a contact; Plus takes acount of logging on/off, and presence in Raid Groups to avoid repeated counting when joining someone already in your Raid group; Plus, added a button to manually reduce/reset the Party count.
- Changed Text Edit Box behaviour, to allow for movement while edit boxes are up. Controlled by a new CheckBox Option. When Checked, pressing Escape while Editing a note's Text, will lose focus, and allow you to move and interact with WoW, while the notes Edit Frame is Open. Pressing Escape again will close the note. The downside is that all NotesUNeed frames will then work off the same press of the Escape key, and pressing Escape to close a Frame will close both General and Contact note Frames and the Search Frame.)
- When the Merchant Frame is up and you have that merchant targetted, the NPC information gathered will include a list of that Merchants goods for sale and prices.
- Can now Alt-Click on Items in the Auction House to Create/Edit a NotesUNeed note on them (Shift-Alt-Click which is the standard NotesUNeed way of noting items will not work in the Auction Frame, so Alt & Click only, no Shift ) Please ensure you are over the Picture of the item and the Game Tooltip is showing before AltClicking, otherwise, the note created may be for the incorrect item. Please don't report this as a bug ;)
- Added an option to only show a minimised version of the NotesUNeed tooltip when you mouseover a target
- Added a Delete confirmation box. Must press <Enter> or click on confirmation Delete to delete a note. Can click on confirmation Cancel or press <Escape> key to cancel the delete. ( This is not controlled by an option - but I have tried to ensure that you should be able to press Escape/Enter to Cancel/Confirm the Delete; Note that if you shift focus to another Edit Box on screen while the Delete confirmation Frame is visible, then Escape and Enter will be captured by that Edit Box, and will no longer control confirmation/cancellation of note deletion. )
- Addressed an issue which may have been causing the game to freeze/hang on a small number of installations

GERMAN LOCALISATION
-------------------
- Included German Localisation, with Slash command functions to patch Notes saved in the English Version. See the Patching NotesUNeed Language section of the Readme.txt.








Changes in v2.04.1800 from v2.03.1800
-------------------------------------

- Fixed the issue of the Right-Click drop down menu not appearing in the Friend's Frame, when a NotesUNeed Contact note is open.

- ( Internal : standardised ALL function hooking )





Changes in v2.03.1800 from v2.02.1800
-------------------------------------

- Fixed a problem that can cause a corrupted NotesUNeed database when transmitting very large Notes via the Send Note functionality
(Please be aware that as well as the character limit in Text boxes, there also appears to be a WoW limit of 110 new line characters. If a note contains more carriage returns than this limit, then text AFTER this limit will be replaced by "..." on screen. I believe the text you enter is still recorded in WoW, but it is no longer visible. This seems to be a WoW Edit Box limitation, and I can't do anything about it so please don't ask ;)

- Added Version number to Options Frame




Changes in v2.02.1800 from v2.01.1800
-------------------------------------

- Pin Up NotesUNeed Tooltip will still display even when all other NotesUNeed tooltips have been turned off. So Mouse-Over dynamic tooltips will NOT display unless you check the option, but you can still see the pin up tooltip which only shows when the static Game Tooltip shows, or you manually Pin a note's tooltip to the screen.




Changes in v2.01.1800 from v2.00.1800
-------------------------------------

- The Tooltip checkbox/slash command now toggle ALL NotesUNeed tooltips, not just the help tips.
- New slash command and key binding for toggling the display of the Micro buttons  ( /nun -micro )





Changes in v2.00 from v1.08
---------------------------


Please Note every effort has been made to ensure that you will lose no notes or data by upgrading to Version 2 which is fully compatible with the previous version's notes, even with all the extra functionality and the extension to cover new note sub-types. However, I would still strongly advise that you back up your NotesUNeed.lua data file from the Saved Variables directory under your Account name in the WoW game folder, as I can not foresee all possible conflict issues, and if you have problems, your existing NotesUNeed data may be at risk.


New Functionality in v2.00
--------------------------

- Can now create Notes for  TARGETTED NPCs by clicking the Contact Microbutton (or typing    /nun -t   when you have an NPC targetted)

- Can now create Notes for Items by Shift-Alt-Clicking on Items in bags, or the character sheet, or Hyperlinks in the Chat Frame. See the Item Notes section of the Readme file.

- Can now create Notes on Quests in the Quest Log - See the Quests section of the Readme for further information

- New Buttons and Note Tooltips in the Friends, Ignores, Who, both Guild Panels, and the Quest Log Frames.

- NotesUNeed mouseover tooltips for Player Characters, NPCs, and Items.

- Can pin a NotesUNeed Tooltip to the screen so that information from that note is easily available while you play. This static tooltip also appears if you Shift-Click an item in the Chat frame that has a NotesUNeed note.

- Can control the size of the NotesUNeed Tooltip from the Options Frame and control the contents of the NotesUNeed tooltip. See the NotesUNeed Tooltips Section of the Readme file.

- Can now create Player Character Notes by Shift-Alt-Clicking on Player names in the Chat Frame.

- Can now create Player Character Notes from the command line for any character name without validation. See the Command Line and Creating Player Notes sections of the Readme file.

- Set NotesUNeed to automatically record Quest Notes and Quest History for your characters - See the Quest section of the Readme for further information

- Can now change the name of General Notes. ( You will not be allowed to change the name if a note already exists with that name )

- Can now save General Notes at account level to be viewed by your Alts from any server/realm. Set the default save level in the Options

- Can now send your NotesUNeed notes via chat channels to Raid, Party, Guild, Say, Whisper, Self.  A log of the last ten transmissions with a datestamp is kept via a new NotesUNeed Log type note, viewable in the search frame like any other Note. See the Send Notes Section of the Readme for further details.

- Filter your notes by any of the new Note types, Item Notes (ITM),  NPC Notes (NPC), Quest Notes (QST), Logs (LOG), or generic notes without any type. ( Obviously notes from previous versions will fall in to this last category, but it is possible to change a Notes type, and reclassify your existing notes )

- Browse your Quest History, including details of when and where you accepted, completed, and handed them in.

- When creating a note from a targetted Player Character (of your Faction), the Players equipment will be displayed in the new note.

- The NotesUNeed Frames and tooltips can now be scaled and moved.

- Key bindings have been added for toggling the Options screen, and for Capturing a NotesUNeed note for the current target without opening a Note Frame. This can also be achieved by Shift-Clicking the Contact Microbutton while targetting something.

- The Search Frame now displays extra information about notes, including the type; A tick beside a note indicates it has been saved at Account Level. This frame now shows the number of notes being displayed in the header. ( These rules differ slightly when viewing Quest History - see the Quests secion of the Readme )

- The Note editing windows display the number of characters used from the maximum available in the lower right hand corner of the scrolling edit box.

- Shift Click on a note in the Search Frame to output its title to the Chat message box

- Raid Frame Support ( No individual Raid Member buttons, but click on a Raid member in the Raid Frame and then click on the NotesUNeed  Button at the left end of the Friends Frame header to create/edit that player's note. Also, NotesUNeed tooltips will show when Mousing over Raid Members in the Raid Frame, or Over Party member Unit Frames )

- Limited support for Hyperlinks and Coloured Text within notes. See the Hyperlinks in NotesUNeed Notes section of the Readme file.



Modifications to Functionality in v2.00
---------------------------------------

- Only import Contacts to the Friends List that are in the Friends List of at least one Alt.
- The NotesUNeed 'Edit' Button on the FriendsFrame has been moved to a graphical button at the left side of the Frame Header.
- Increased the maximum possible size of notes to 5056. ( This does NOT increase the size of ALL notes, or mean you are using more memory, unless you FILL the note )










Changes in v1.08 from v1.07
---------------------------

- Fixed a problem with the Text search functionality beyond the 1012th character
- Fixed a small graphical glitch in the Edit Details Box in the Contact Note





Changes in v1.07 from v1.06
---------------------------

- Fixed the Self-Targetting Issue
- Fixed the Levelling message to report the new Level, not the Old ( Caused by changes in WoW Patch 1.8 ? )
- Fixed the Options Reset functionality to correctly set the Default options and refresh the Options Frame view




Changes in v1.06 from v1.05
---------------------------

- Fixed the error message that appears on levelling.




Changes in v1.05 from v1.04
---------------------------

- Very minor '.toc' file update for compatibility with WoW patch 1.8




Changes in v1.04 from v1.03
---------------------------

- Very minor change to make the default position for the Microbuttons near the Top Center of the screen. The default position now has no relationship with any other frame.




Changes in v1.03 from v1.02
---------------------------

- Note that installation of this version to replace an older version will NOT result in any loss of existing notes or data
- Fixed the problem of Text being truncated to 1012 characters by the WoW Saved Variables limit. Up to 4048 characters can now be entered and saved
- Stopped self targetting when exiting own note via Microbutton press
- Minor changes to make the hiding and showing of frames more consistent



Changes in v1.02 from v1.01
---------------------------

- Fixed the error being reported when logging in to a character in different Realms



Changes in v1.01 from v1.0
--------------------------

- Very minor change to display a border around the Microbuttons when the mouse pointer is over the frame. Hopefully should clear up any issues new users have with moving the panel, as it is the border which needs to be clicked to move the buttons, and this border was not previously visible.











Contact for Feedback & Bug Reports
----------------------------------

telic@hotmail.co.uk



